IPcl.addressListMembers
addressListMembers(
uint64 listId,
PageRequest calldata pageRequest
) external view returns (address[] memory members, PageResponse memory pageResponse) 공유 주소 리스트 하나의 멤버 주소를 페이지네이션하여 조회합니다. 멤버는 바이트 기준 정렬 순서로 반환되며, 이 집합이 ALLOW_LIST_POLICY 또는 DENY_LIST_POLICY가 평가하는 집합과 동일합니다. 리스트가 Active이든 Disabled이든 조회는 성공합니다. status는 정책 평가에만 영향을 주며 조회에는 영향을 주지 않습니다. 존재하지 않는 리스트는 AddressListNotFound(listId)로 revert됩니다.
파라미터
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
listId | uint64 | ✓ | 멤버를 조회할 리스트의 0이 아닌 레지스트리 ID입니다. 0을 전달하면 InvalidAddressListConfig(listId)로 revert됩니다. |
pageRequest | PageRequest | ✓ | 표준 페이지네이션 입력입니다(key, offset, limit, countTotal, reverse). 호출 사이에서 pageResponse.nextKey를 pageRequest.key에 넣어 이어서 조회합니다. |
반환값
타입:
(address[] members, PageResponse pageResponse) members는 바이트 기준 정렬 순서로 반환되는 멤버 주소 페이지입니다. 마지막 페이지가 반환되면 pageResponse.nextKey는 비어 있습니다.
에러
| 코드 | 이름 | 설명 |
|---|---|---|
AddressListNotFound | AddressListNotFound | listId에 해당하는 리스트가 레지스트리에 없을 때 AddressListNotFound(uint64 listId)로 revert됩니다. |
InvalidAddressListConfig | InvalidAddressListConfig | listId가 0이거나 반복 중 저장된 멤버 항목이 내부적으로 일관되지 않을 때 InvalidAddressListConfig(uint64 listId)로 revert됩니다. |
InvalidPageRequest | InvalidPageRequest | IPrecompile에서 상속됩니다. PageRequest 튜플을 변환할 수 없을 때만 발생합니다. key와 offset을 동시에 설정한 경우는 페이지네이션 계층에서 거절되어 QueryFailed("addressListMembers", reason)로 도달합니다. InvalidPageRequest(string method, uint256 index, string value)로 인코딩됩니다. |
AddressListStorageError | AddressListStorageError | 체인 계층 반복자가 실패할 때 AddressListStorageError(uint64 listId)로 revert됩니다. |
ABISetupFailed | ABISetupFailed | IPrecompile에서 상속됩니다. 프리컴파일 ABI로 calldata를 디코딩할 수 없을 때 ABISetupFailed(string reason)로 revert됩니다. |
예제
viem으로 리스트의 모든 멤버 내보내기
nextKey가 비어서 돌아올 때까지 200개 단위로 멤버를 순회합니다. 반환된 배열은 ALLOW_LIST_POLICY / DENY_LIST_POLICY가 평가하는 집합과 동일합니다.
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"),
});
async function exportMembers(listId: bigint): Promise<string[]> {
const out: string[] = [];
let nextKey: Hex = "0x";
do {
const [members, page] = await publicClient.readContract({
address: iPclAddress,
abi: iPclAbi,
functionName: "addressListMembers",
args: [listId, {
key: nextKey,
offset: 0n,
limit: 200n,
countTotal: false,
reverse: false,
}],
});
out.push(...members);
nextKey = page.nextKey;
} while (nextKey !== "0x" && nextKey.length > 2);
return out;
}
const snapshot = await exportMembers(1n);
console.log(`list 1 has ${snapshot.length} members`); Solidity에서 첫 페이지 조회
첫 페이지의 멤버와 다음 페이지를 조회하기 위한 cursor를 반환합니다. nextKey가 비어 있으면 전체 멤버가 한 페이지에 모두 담겼다는 의미입니다.
// SPDX-License-Identifier: Apache-2.0
pragma solidity ^0.8.28;
import {IPcl, PCL_CONTRACT} from "@maroo-chain/contracts/precompiles/pcl/IPcl.sol";
import {PageRequest, PageResponse} from "cosmos-evm-contracts/precompiles/common/Types.sol";
contract AddressListAudit {
function firstPage(uint64 listId, uint64 limit)
external
view
returns (address[] memory members, bytes memory nextKey)
{
PageRequest memory req = PageRequest({
key: "",
offset: 0,
limit: limit,
countTotal: false,
reverse: false
});
PageResponse memory page;
(members, page) = PCL_CONTRACT.addressListMembers(listId, req);
nextKey = page.nextKey;
}
}