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 ...
}
}