IPcl.addressLists
addressLists(
PageRequest calldata pageRequest
) external view returns (AddressList[] memory lists, PageResponse memory pageResponse) PCL 프리컴파일에 등록된 모든 공유 주소 리스트를 숫자 ID 순으로 페이지네이션하여 조회합니다. 반환되는 각 AddressList는 메타데이터({ id, admin, status })만 담기 때문에 레지스트리가 큰 네트워크에서도 안전하게 호출할 수 있습니다. 특정 리스트의 멤버는 addressListMembers(listId, …)로 조회합니다. Active와 Disabled 리스트가 모두 반환되므로, 정책 감사에서 비활성 리스트를 제외하려면 클라이언트에서 status로 필터링합니다.
파라미터
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
pageRequest | PageRequest | ✓ | 표준 페이지네이션 입력입니다(key, offset, limit, countTotal, reverse). 첫 페이지에는 { key: "0x", offset: 0, limit: 100, countTotal: false, reverse: false }를 전달하고, 이후 호출에서는 pageResponse.nextKey를 pageRequest.key에 넣어 이어서 조회합니다. |
반환값
타입:
(AddressList[] lists, PageResponse pageResponse) lists는 숫자 id 오름차순(또는 reverse를 설정하면 내림차순)으로 정렬된 메타데이터 튜플 페이지입니다. 마지막 페이지가 반환되면 pageResponse.nextKey는 비어 있습니다.
에러
| 코드 | 이름 | 설명 |
|---|---|---|
InvalidPageRequest | InvalidPageRequest | IPrecompile에서 상속됩니다. PageRequest 튜플을 변환할 수 없을 때만 발생합니다. key와 offset을 동시에 설정한 경우는 페이지네이션 계층에서 거절되어 QueryFailed("addressLists", reason)로 도달합니다. InvalidPageRequest(string method, uint256 index, string value)로 인코딩됩니다. |
InvalidAddressListConfig | InvalidAddressListConfig | 반복 중 저장된 리스트의 메타데이터가 내부적으로 일관되지 않을 때 InvalidAddressListConfig(uint64 listId)로 revert됩니다. |
AddressListStorageError | AddressListStorageError | 레지스트리 반복자가 실패할 때 AddressListStorageError(uint64 listId)로 revert됩니다. 구체적 원인은 외부로 노출되지 않습니다. |
ABISetupFailed | ABISetupFailed | IPrecompile에서 상속됩니다. 프리컴파일 ABI로 calldata를 디코딩할 수 없을 때 ABISetupFailed(string reason)로 revert됩니다. |
예제
viem으로 모든 주소 리스트 페이지네이션
nextKey가 비어서 돌아올 때까지 100개 단위로 레지스트리를 순회합니다. 와이어에는 메타데이터만 실리며, 각 리스트의 주소는 필요한 경우 별도로 조회합니다.
import { createPublicClient, http, type Hex } from "viem";
import { iPclAbi, iPclAddress } from "@maroo-chain/contracts/abi/precompiles/pcl/IPcl";
const publicClient = createPublicClient({
transport: http("https://rpc-testnet.maroo.io"),
});
let nextKey: Hex = "0x";
do {
const [lists, page] = await publicClient.readContract({
address: iPclAddress,
abi: iPclAbi,
functionName: "addressLists",
args: [{
key: nextKey,
offset: 0n,
limit: 100n,
countTotal: false,
reverse: false,
}],
});
for (const list of lists) {
// status: 1 = Active, 2 = Disabled.
console.log(`list ${list.id} admin=${list.admin} status=${list.status}`);
}
nextKey = page.nextKey;
} while (nextKey !== "0x" && nextKey.length > 2); Solidity에서 Active 리스트만 필터링
한 페이지를 읽어 status가 Active인 ID만 반환합니다. 실제 감사에서는 pageResponse.nextKey가 빌 때까지 반복합니다.
// SPDX-License-Identifier: Apache-2.0
pragma solidity ^0.8.28;
import {IPcl, AddressList, AddressListStatus, PCL_CONTRACT} from "@maroo-chain/contracts/precompiles/pcl/IPcl.sol";
import {PageRequest, PageResponse} from "cosmos-evm-contracts/precompiles/common/Types.sol";
contract ActiveLists {
function firstActivePage(uint64 limit) external view returns (uint64[] memory activeIds) {
PageRequest memory req = PageRequest({
key: "",
offset: 0,
limit: limit,
countTotal: false,
reverse: false
});
(AddressList[] memory lists, ) = PCL_CONTRACT.addressLists(req);
uint256 count;
activeIds = new uint64[](lists.length);
for (uint256 i; i < lists.length; ++i) {
if (lists[i].status == AddressListStatus.Active) {
activeIds[count++] = lists[i].id;
}
}
// Trim the trailing zero slots in place.
assembly { mstore(activeIds, count) }
}
}