ALLOW_LIST_POLICY
선택된 엔드포인트(From, To, Both)가 공유 주소 리스트의 멤버일 때만 호출을 허용하는 컨트랙트 범위 정책입니다.
ALLOW_LIST_POLICY는 listId로 공유 주소 리스트를 참조하고 선택된 모든 엔드포인트(From, To, 또는 양쪽)가 해당 리스트의 멤버일 때만 호출을 허용하는 컨트랙트 범위 PCL 정책 템플릿입니다. 전역 범위에서는 사용할 수 없습니다. 전역 범위에서 빈 리스트는 체인의 모든 트랜잭션을 차단하기 때문입니다. 멤버십을 근거로 거절하는 DENY_LIST_POLICY와 달리, 이 템플릿은 부재를 근거로 거절합니다. 검사 대상 엔드포인트가 리스트에 없으면 호출은 NotInAddressList(listId, account)로 revert됩니다. 정책은 리스트 참조와 타깃만 담으며, 멤버십은 평가 시점에 레지스트리에서 읽습니다. 따라서 리스트를 갱신하면 이 리스트를 참조하는 모든 정책에 즉시 반영됩니다. 테스트넷(v0.11.1)에는 아직 등록되지 않아, 바인딩하면 PolicyNotRegistered("ALLOW_LIST_POLICY")로 revert됩니다.
파라미터 struct
IPcl.sol에서 가져왔습니다.enum AddressListTarget { Unspecified, From, To, Both }
struct AllowListPolicy {
uint64 listId; // 공유 주소 리스트의 id (IPcl.createAddressList 참고)
AddressListTarget target; // 검사할 호출 엔드포인트
}
// 템플릿 id: "ALLOW_LIST_POLICY"
// ABI 튜플: (uint64, uint8) 테스트넷 사용 가능 여부. 두 주소 리스트 템플릿 중 테스트넷(v0.11.1)에 등록된 것은
DENY_LIST_POLICY뿐입니다. ALLOW_LIST_POLICY는 체인 코드에 들어 있지만 정책 관리자가 registerPolicyTemplate으로 등록하기 전까지는 사용할 수 없으며, 그동안 바인딩하면 PolicyNotRegistered("ALLOW_LIST_POLICY")로 revert됩니다. 먼저 policyTemplate("ALLOW_LIST_POLICY")로 확인합니다. 템플릿이 없는 동안에는 이 호출이 PolicyTemplateNotFound로 revert됩니다.listId는 존재하는 리스트를 참조해야 합니다. 존재하지 않는 id에 정책을 바인딩하면 AddressListNotFound(listId)로 revert됩니다. Disabled 상태의 리스트도 바인딩할 수는 있지만, Disabled인 동안에는 정책을 평가할 때마다 AddressListDisabled(listId)로 revert됩니다. target은 From, To, Both 중 하나여야 합니다. 리스트를 조회하기 전에 정책 자체의 형태를 먼저 검사하므로, listId가 0이거나 target이 Unspecified 또는 범위 밖이면 바인딩 호출이 InvalidAddressListConfig가 아니라 InvalidParameter(bytes)로 revert됩니다. 전역 범위에 바인딩하면 InvalidAddressListConfig(listId)로 revert됩니다.평가와 타깃 의미
평가 시점에 PCL은 호출에서 해당 엔드포인트를 읽습니다.
From은 송신자만, To는 수신자만, Both는 각각을 독립적으로 검사합니다. 정책이 검사하는 모든 엔드포인트에 대해, 그 계정이 리스트의 멤버가 아니면 정책은 NotInAddressList(listId, account)로 거절합니다. 검사 대상 엔드포인트가 모두 멤버여야 정책이 허용합니다. 이 템플릿은 컨트랙트 범위 전용이므로, ALLOW_LIST_POLICY가 바인딩된 PCL 래핑 프록시를 호출이 경유할 때만 발동합니다(프록시의 preCall/postCall, 신뢰된 EntryPoint 경유, 또는 정책 인식 Privacy 프리컴파일 내부).import { encodeAbiParameters, toHex } from "viem";
// 송신자와 수신자 양쪽 모두 리스트에 있을 때만 허용합니다.
const allowBytes = encodeAbiParameters(
[
{ type: "uint64", name: "listId" },
{ type: "uint8", name: "target" }, // 3 = Both
],
[listId, 3],
);
const policySet = {
templateId: "ALLOW_LIST_POLICY",
policy: allowBytes,
selector: toHex("", { size: 0 }), // 이 범위의 모든 호출
}; 컨트랙트 바인딩과 멤버 관리
ALLOW_LIST_POLICY는 IPcl.changeContractPolicies로 특정 PCL 래핑 프록시에 바인딩합니다. 호출자는 현재 컨트랙트 정책 admin이어야 합니다. 참조되는 리스트는 독립적으로 관리됩니다. 리스트 admin(컨트랙트 정책 admin과 같을 수도, 다를 수도 있습니다)이 IPcl.updateAddressList(listId, add, remove)로 멤버십을 제어하며, 멤버 집합이 바뀌어도 PolicySet을 갱신할 필요가 없습니다. 리스트 소유권을 다른 계정으로 넘기려면 IPcl.changeAddressListAdmin을 사용합니다. IPcl.setAddressListStatus(listId, AddressListStatus.Disabled)는 정책을 일시 중단하지 않습니다. 리스트가 다시 활성화될 때까지 그 리스트를 참조하는 모든 정책이 AddressListDisabled(listId)로 revert되므로, 컨트랙트는 정책이 적용되는 모든 호출을 거절합니다. 리스트가 정책 트리의 어디에 있든 마찬가지입니다. 체인은 평가 전에 정책이 참조하는 모든 리스트를 다시 검사하므로, OR 안의 Disabled 리스트도 앞의 자식이 통과하는지와 관계없이 호출을 거절합니다. allow 리스트 적용을 멈추려면 정책을 제거하거나 교체합니다.import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { iPclAbi, iPclAddress } from "@maroo-chain/contracts/abi/precompiles/pcl/IPcl";
const admin = privateKeyToAccount(process.env.ADMIN_KEY as `0x${string}`);
const wallet = createWalletClient({
account: admin,
transport: http(process.env.MAROO_RPC_URL),
});
// TODO: 프로덕션 배포 전 실제 프록시 주소로 교체하십시오.
const proxyAddress = "0x8f3ac2b1d9e74c05a6b18fe27dc4913e5a0f7b62";
await wallet.writeContract({
address: iPclAddress,
abi: iPclAbi,
functionName: "changeContractPolicies",
args: [{
_contract: proxyAddress,
admin: admin.address,
policies: [policySet],
}],
}); ReasonCode
평가는
IPcl에 선언된 다음 타입 지정 오류로 revert될 수 있습니다. iPclAbi를 사용해 decodeErrorResult로 디코드합니다.| ReasonCode | 발생 조건 |
|---|---|
NotInAddressList(uint64 listId, address account) | 검사 대상 엔드포인트가 리스트의 멤버가 아닐 때 |
AddressListNotFound(uint64 listId) | 참조한 리스트가 존재하지 않을 때 |
AddressListDisabled(uint64 listId) | 참조한 리스트의 상태가 Disabled일 때 |
InvalidAddressListConfig(uint64 listId) | 참조한 리스트의 저장 레코드가 무결성 검사에 실패했을 때(레지스트리 손상). 0인 listId나 잘못된 target은 여기까지 오지 않고 바인딩 시점에 InvalidParameter로 거절됩니다 |
AddressListStorageError(uint64 listId) | 예상치 못한 스토리지 읽기 실패(정상 노드에서는 발생하지 않습니다) |