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