IPcl.isAddressListed

isAddressListed(
  uint64 listId,
  address account
) external view returns (bool)

account이 공유 주소 리스트 listId의 현재 멤버인지 확인합니다. 상수 시간 멤버십 조회이며, addressListMembers로 페이지네이션하기에는 비효율적인 핫 경로에서 사용합니다. 리스트가 Active이든 Disabled이든 조회는 성공합니다. status는 정책 평가에만 영향을 주며 조회에는 영향을 주지 않습니다. 존재하지 않는 리스트는 AddressListNotFound(listId)로 revert됩니다.

파라미터

이름 타입 필수 설명
listId uint64 ✓ 조회할 리스트의 0이 아닌 레지스트리 ID입니다. 0을 전달하면 InvalidAddressListConfig(listId)로 revert됩니다.
account address ✓ 멤버십을 확인할 계정입니다. 영 주소도 일반 조회 대상으로 취급됩니다. 영 주소가 리스트에 명시적으로 추가되어 있으면 true를 반환합니다.

반환값

타입: bool

account이 리스트에 저장되어 있으면 true, 아니면 false를 반환합니다. 반환값은 리스트 status에 의존하지 않습니다. Disabled 리스트도 정확한 값을 반환하지만, 이 리스트를 참조하는 정책은 평가 시점에 AddressListDisabled(listId)로 revert됩니다.

에러

코드 이름 설명
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를 디코딩할 수 없을 때 ABISetupFailed(string reason)로 revert됩니다.

예제

viem으로 전송 사전 검증

전송에 서명하기 전에 수신자를 제재 deny-list와 대조합니다. 온체인 DENY_LIST_POLICY도 이를 잡아내지만, 사전 검증으로 가스가 소모되는 실패 트랜잭션을 피할 수 있습니다.

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"),
});

// A sanctions deny list. In production, discover the listId through your
// policy admin or a governance-published registry rather than hard-coding it.
const SANCTIONS_LIST_ID = 1n;

// TODO: replace with the real recipient before production.
const recipient = "0x5ab7c1e40b8da46f9c7e29d3fa614e97b8f0ac21";

const blocked = await publicClient.readContract({
  address: iPclAddress,
  abi: iPclAbi,
  functionName: "isAddressListed",
  args: [SANCTIONS_LIST_ID, recipient],
});

if (blocked) {
  throw new Error(`recipient ${recipient} is on the sanctions list`);
}

Solidity 진입점 보호

modifier에서 프리컴파일 조회를 사용해 컨트랙트가 자체 진입점을 allow-list 멤버십으로 게이팅합니다. 템플릿이 등록되면 프록시 수준의 ALLOW_LIST_POLICY로 PCL 등록 프록시를 거치는 모든 호출에 같은 규칙을 강제할 수 있습니다(테스트넷에는 아직 등록되지 않았습니다). 그 전까지, 또는 컨트랙트가 그런 프록시 뒤에 있지 않을 때는 이런 인라인 검사로 리스트 기반 게이팅을 합니다.

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

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

contract AllowListGate {
    uint64 public immutable listId;

    error NotAllowed(address account);

    constructor(uint64 _listId) {
        listId = _listId;
    }

    modifier onlyListed(address account) {
        if (!PCL_CONTRACT.isAddressListed(listId, account)) {
            revert NotAllowed(account);
        }
        _;
    }

    function doPrivilegedWork() external onlyListed(msg.sender) {
        // ... privileged action ...
    }
}
ESC
검색어를 입력하세요