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;
    }
}
ESC
검색어를 입력하세요