DENY_LIST_POLICY
선택된 엔드포인트(From, To, Both) 중 하나라도 공유 주소 리스트의 멤버이면 호출을 거절하는 전역 또는 컨트랙트 범위 정책입니다.
DENY_LIST_POLICY는 listId로 공유 주소 리스트를 참조하고 선택된 엔드포인트(From, To, 또는 양쪽) 중 하나라도 해당 리스트의 멤버이면 호출을 거절하는 PCL 정책 템플릿입니다. 자체 address[]를 담던 v0.10의 인라인 DENYLIST_POLICY를 대체합니다. 해당 템플릿 ID는 이제 예약되어 있고 테스트넷은 UnknownPolicyType으로 거절합니다. 이전 템플릿과 달리 DENY_LIST_POLICY는 여러 정책이 공유할 수 있습니다. 같은 제재 리스트가 전역 체인 전역 규칙과 여러 컨트랙트 범위 규칙을 동시에 지원할 수 있으며, 리스트 admin이 멤버십을 갱신해도 PolicySet을 다시 작성할 필요가 없습니다. 전역과 컨트랙트 범위 모두에서 사용할 수 있습니다.
파라미터 struct
IPcl.sol에서 가져왔습니다.enum AddressListTarget { Unspecified, From, To, Both }
struct DenyListPolicy {
uint64 listId; // 공유 주소 리스트의 id (IPcl.createAddressList 참고)
AddressListTarget target; // 검사할 호출 엔드포인트
}
// 템플릿 id: "DENY_LIST_POLICY"
// ABI 튜플: (uint64, uint8) listId는 존재하는 리스트를 참조해야 합니다. 존재하지 않는 id에 정책을 바인딩하면 AddressListNotFound(listId)로 revert됩니다. Disabled 상태의 리스트도 바인딩할 수는 있지만, Disabled인 동안에는 정책을 평가할 때마다 AddressListDisabled(listId)로 revert됩니다. target은 From, To, Both 중 하나여야 합니다. 리스트를 조회하기 전에 정책 자체의 형태를 먼저 검사하므로, listId가 0이거나 target이 Unspecified 또는 범위 밖이면 바인딩 호출이 InvalidAddressListConfig가 아니라 InvalidParameter(bytes)로 revert됩니다. v0.11부터는 v0.10의 DenylistPolicy가 제거되어, 인라인 address[] addresses 형태는 현재 IPcl.sol로 컴파일되지 않고 체인에서도 거절됩니다. 해당 멤버들로 주소 리스트를 만들고 그 리스트를 참조하는 DENY_LIST_POLICY를 바인딩하는 방식으로 마이그레이션합니다.범위와 평가
DENY_LIST_POLICY는 두 범위 모두에서 허용됩니다.- 전역 —
IPcl.setGlobalPolicies로 바인딩합니다. 정책은 체인의 모든 트랜잭션에 대해 평가됩니다. 트랜잭션 자체의 호출에서 PCL은msg.sender를From엔드포인트로, 직접 수신자를To로 검사합니다. - 컨트랙트 —
IPcl.changeContractPolicies(ContractPolicyConfig)로 바인딩합니다. 정책은 이 정책이 바인딩된 PCL 래핑 프록시를 호출이 경유할 때만 발동합니다. 프록시는 자신을 직접 호출한 주소(msg.sender)를principal로 전달합니다. EOA가 호출하거나 AA 스마트 계정이 UserOperation을 실행하며 호출하면 그것이 최종 사용자이지만, Multicall3나 라우터를 거치면 라우터 컨트랙트가 되므로 컨트랙트 범위 리스트는 사용자가 아니라 라우터를 검사합니다.
두 범위 모두 규칙은 같습니다. 검사 대상 엔드포인트 중 하나라도 리스트의 멤버이면 정책은 해당 계정을 담은
InAddressList(listId, account)로 거절합니다. Both는 첫 매치에서 단축 평가로 종료됩니다.import { encodeAbiParameters, toHex } from "viem";
// 체인 전역 제재 검사: 송신자 또는 수신자 중 하나라도 리스트에 있으면 거절.
const denyBytes = encodeAbiParameters(
[
{ type: "uint64", name: "listId" },
{ type: "uint8", name: "target" }, // 3 = Both
],
[sanctionsListId, 3],
);
const globalPolicy = {
templateId: "DENY_LIST_POLICY",
policy: denyBytes,
selector: toHex("", { size: 0 }), // 전역의 모든 호출에 적용
}; 리스트 공유와 정책을 건드리지 않는 운영
v0.10 인라인 템플릿과 비교해 실질적인 가장 큰 차이는, 공유 리스트 하나가 체인 전역
DENY_LIST_POLICY와 여러 컨트랙트 범위 정책을 동시에 지원할 수 있다는 점입니다. 리스트 admin이 IPcl.updateAddressList(listId, add, remove)를 호출하면 변경 사항이 다음 평가부터 이 리스트를 참조하는 모든 정책에 반영됩니다. 각 PolicySet에 리스트를 다시 인코딩할 거버넌스 제안도, 뒤처진 복사본도 필요 없습니다. IPcl.setAddressListStatus(listId, AddressListStatus.Disabled)로 리스트를 비활성화하는 것은 리스트 적용을 멈추는 방법이 아닙니다. 리스트가 다시 활성화될 때까지 이 리스트를 참조하는 모든 정책이 AddressListDisabled(listId)로 revert되므로, 비활성화된 리스트를 참조하는 전역 DENY_LIST_POLICY는 체인의 모든 트랜잭션을 거절합니다. 리스트가 정책 트리의 어디에 있든 마찬가지입니다. 체인은 평가 전에 정책이 참조하는 모든 리스트를 다시 검사하므로, OR 안의 Disabled 리스트도 앞의 자식이 통과하는지와 관계없이 호출을 거절합니다. 리스트 적용을 멈추려면 그 리스트를 참조하는 정책의 바인딩을 해제하거나 정책을 교체합니다. admin 회전은 IPcl.changeAddressListAdmin으로 수행하며 원자적입니다. 호출이 성공하는 순간 이전 admin은 수정 권한을 잃습니다.import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { iPclAbi, iPclAddress } from "@maroo-chain/contracts/abi/precompiles/pcl/IPcl";
const listAdmin = privateKeyToAccount(process.env.LIST_ADMIN_KEY as `0x${string}`);
const wallet = createWalletClient({
account: listAdmin,
transport: http(process.env.MAROO_RPC_URL),
});
// 새로 제재된 두 주소를 추가하고, 해제된 한 주소를 제거합니다.
// TODO: 프로덕션 배포 전 실제 주소로 교체하십시오.
const add = [
"0x2c7f09b81a6d3ff1e5a0d4c6bc2a8f7e19dc3a4b",
"0x3a9c71e4b8d2f6a05c7e19b4d3f82a6c5e0b9d47",
] as const;
const remove = ["0x5ab7c1e40b8da46f9c7e29d3fa614e97b8f0ac21"] as const;
await wallet.writeContract({
address: iPclAddress,
abi: iPclAbi,
functionName: "updateAddressList",
args: [sanctionsListId, add, remove],
}); ReasonCode와 마이그레이션 노트
평가는
폐지된
IPcl에 선언된 다음 타입 지정 오류로 revert될 수 있습니다. iPclAbi로 decodeErrorResult를 사용해 디코드합니다.| ReasonCode | 발생 조건 |
|---|---|
InAddressList(uint64 listId, address account) | 검사 대상 엔드포인트가 리스트의 멤버일 때 |
AddressListNotFound(uint64 listId) | 참조한 리스트가 존재하지 않을 때 |
AddressListDisabled(uint64 listId) | 참조한 리스트의 상태가 Disabled일 때 |
InvalidAddressListConfig(uint64 listId) | 참조한 리스트의 저장 레코드가 무결성 검사에 실패했을 때(레지스트리 손상). 0인 listId나 잘못된 target은 여기까지 오지 않고 바인딩 시점에 InvalidParameter로 거절됩니다 |
AddressListStorageError(uint64 listId) | 예상치 못한 스토리지 읽기 실패(정상 노드에서는 발생하지 않습니다) |
폐지된
DENYLIST_POLICY는 더 이상 존재하지 않습니다. v0.11로 업그레이드할 때 저장된 모든 인라인 denylist는 마이그레이션됩니다. 멤버를 담은 새 주소 리스트를 만들고, 정책 항목은 새 listId를 참조하는 DENY_LIST_POLICY로 교체됩니다. 컨트랙트 범위 정책의 경우 새 리스트는 해당 설정의 admin을 상속하므로 같은 계정이 멤버십을 계속 관리합니다. 전역 정책의 경우 체인의 정책 admin이 마이그레이션된 리스트의 소유권을 상속합니다.