IPcl.addressList

addressList(uint64 listId) external view returns (AddressList memory)

PCL 프리컴파일의 공유 주소 리스트 레지스트리에서 특정 리스트의 메타데이터를 읽습니다. { id, admin, status } 구조의 AddressList 튜플을 반환하며, 멤버 주소는 포함하지 않습니다. 멤버 목록은 addressListMembers로 페이지네이션하여 조회합니다. status는 리스트가 Active(정책이 평가할 수 있음)인지 Disabled(이 리스트를 참조하는 정책은 평가 시 AddressListDisabled(listId)로 revert되지만 조회는 여전히 가능함)인지를 나타냅니다. 이 레지스트리는 ALLOW_LIST_POLICY와 DENY_LIST_POLICY의 공통 저장소입니다.

파라미터

이름 타입 필수 설명
listId uint64 ✓ 조회할 리스트의 0이 아닌 레지스트리 ID입니다. ID는 createAddressList가 1부터 순차적으로 할당합니다. 0을 전달하면 InvalidAddressListConfig(listId)로 revert됩니다.

반환값

타입: AddressList

(uint64 id, address admin, uint8 status) 튜플입니다. status는 AddressListStatus enum이며 1 = Active, 2 = Disabled입니다. admin은 현재 리스트(멤버, admin, status)를 변경할 권한을 가진 계정입니다.

에러

코드 이름 설명
AddressListNotFound AddressListNotFound listId에 해당하는 리스트가 레지스트리에 없을 때 AddressListNotFound(uint64 listId)로 revert됩니다.
InvalidAddressListConfig InvalidAddressListConfig listId가 0이거나 저장된 메타데이터가 내부적으로 일관되지 않을 때 InvalidAddressListConfig(uint64 listId)로 revert됩니다.
AddressListStorageError AddressListStorageError 위 두 경우가 아닌 사유로 체인 계층 레지스트리 조회가 실패하면 AddressListStorageError(uint64 listId)로 revert됩니다. 구체적 원인은 외부로 노출되지 않습니다.
ABISetupFailed ABISetupFailed IPrecompile에서 상속됩니다. 프리컴파일 ABI로 calldata를 디코딩할 수 없을 때(예: 오래되었거나 불일치하는 ABI) ABISetupFailed(string reason)로 revert됩니다.

예제

viem으로 리스트 메타데이터 조회

리스트 ID 1의 메타데이터 튜플을 조회합니다. 반환된 struct에는 멤버 주소가 담기지 않으며, 멤버는 addressListMembers로 페이지네이션하여 조회합니다.

import { createPublicClient, http } from "viem";
import { iPclAbi, iPclAddress } from "@maroo-chain/contracts/abi/precompiles/pcl/IPcl";

const publicClient = createPublicClient({
  transport: http("https://rpc-testnet.maroo.io"),
});

const list = await publicClient.readContract({
  address: iPclAddress,
  abi: iPclAbi,
  functionName: "addressList",
  args: [1n],
});

// list.status is the AddressListStatus enum: 1 = Active, 2 = Disabled.
console.log(`list ${list.id} admin=${list.admin} status=${list.status}`);

Solidity에서 AddressListNotFound 디코드

try/catch와 4바이트 selector로 AddressListNotFound만 인식하고 다른 revert는 그대로 전파합니다. 반환된 AddressList는 오류를 삼킨 경우에만 영값이 되므로 호출자는 반환된 id를 확인해야 합니다.

// SPDX-License-Identifier: Apache-2.0
pragma solidity ^0.8.28;

import {IPcl, AddressList, PCL_CONTRACT} from "@maroo-chain/contracts/precompiles/pcl/IPcl.sol";

contract AddressListReader {
    event Missing(uint64 listId);

    function tryRead(uint64 listId) external returns (AddressList memory list) {
        try PCL_CONTRACT.addressList(listId) returns (AddressList memory got) {
            return got;
        } catch (bytes memory raw) {
            bytes4 sel;
            assembly { sel := mload(add(raw, 32)) }
            if (sel == IPcl.AddressListNotFound.selector) {
                emit Missing(listId);
                return list; // zero-valued tuple
            }
            // Unknown revert — bubble it up.
            assembly { revert(add(raw, 32), mload(raw)) }
        }
    }
}
ESC
검색어를 입력하세요