IPcl.updateAddressList
updateAddressList(
uint64 listId,
address[] calldata add,
address[] calldata remove
) external 기존 공유 주소 리스트의 멤버를 한 번의 원자적 호출로 추가하거나 제거합니다. 현재 리스트 관리자만 호출할 수 있으며, 그 외 발신자는 Unauthorized로 revert됩니다. 주소별로는 멱등합니다. 이미 있는 멤버를 다시 추가하거나 없는 멤버를 제거해도 revert되지 않고 아무 일도 일어나지 않습니다. 다만 add와 remove 배열을 합쳐 중복된 주소가 있어서는 안 되며, 두 배열이 동시에 비어 있어서도 안 됩니다. 실제로 멤버십이 변경된 주소만 담아 AddressListMembersAdded 또는 AddressListMembersRemoved 이벤트를 발행합니다. 아무것도 바뀌지 않는 호출(add의 주소가 모두 이미 멤버이고 remove의 주소가 모두 멤버가 아닌 경우)은 성공하지만 두 이벤트 모두 발행하지 않으므로, 호출 성공 여부는 이벤트가 아니라 영수증의 상태로 확인합니다. 이 리스트를 참조하는 정책은 다음 평가 시점부터 새 멤버십을 반영합니다.
파라미터
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
listId | uint64 | ✓ | createAddressList가 반환한 대상 리스트의 0이 아닌 ID입니다. 존재하지 않는 ID는 AddressListNotFound(listId)로, ID 0은 InvalidAddressListConfig(0)으로 revert됩니다. |
add | address[] | ✓ | 리스트에 추가할 주소들입니다. remove가 비어 있지 않다면 이 배열은 비어 있어도 됩니다. |
remove | address[] | ✓ | 리스트에서 제거할 주소들입니다. add가 비어 있지 않다면 이 배열은 비어 있어도 됩니다. 같은 주소가 add와 remove에 모두 들어 있으면 중복으로 간주되어 거절됩니다. |
반환값
void 반환값은 없습니다. 실제 변경분은 AddressListMembersAdded / AddressListMembersRemoved 이벤트로 확인합니다. 아무것도 바뀌지 않은 호출은 두 이벤트 모두 발행하지 않습니다.
에러
| 코드 | 이름 | 설명 |
|---|---|---|
Unauthorized | Unauthorized | msg.sender가 listId의 현재 관리자가 아닐 때 revert됩니다. 새 주소에서 호출하려면 먼저 changeAddressListAdmin으로 관리자를 변경합니다. |
AddressListNotFound | AddressListNotFound | 해당 ID의 리스트가 존재하지 않을 때 revert됩니다(ID 0은 대신 InvalidAddressListConfig로 revert됩니다). AddressListNotFound(uint64 listId) 형태로 인코딩됩니다. |
InvalidParameter | InvalidParameter | 두 배열이 모두 비어 있거나, 같은 주소가 add와 remove에 두 번 이상 나타날 때 revert됩니다. 체인 쪽에서는 empty or duplicate address list batch 조건으로 노출됩니다. |
InvalidAddressListConfig | InvalidAddressListConfig | 레지스트리에 저장된 리스트 메타데이터가 무결성 검사를 통과하지 못할 때 revert됩니다. InvalidAddressListConfig(uint64 listId) 형태로 인코딩됩니다. |
AddressListStorageError | AddressListStorageError | 하부 레지스트리 저장소를 읽거나 쓸 수 없을 때 revert됩니다. AddressListStorageError(uint64 listId) 형태로 인코딩됩니다. |
ABISetupFailed | ABISetupFailed | IPrecompile에서 상속됩니다. calldata를 프리컴파일 ABI로 디코딩할 수 없을 때 revert됩니다. |
예제
TypeScript로 두 주소를 추가하고 한 주소를 제거
한 트랜잭션으로 변경분이 원자적으로 적용됩니다. listId를 참조하는 정책은 다음 평가 시점부터 새 멤버십을 반영합니다.
import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { iPclAbi } from "@maroo-chain/contracts/abi/precompiles/pcl/IPcl";
const PCL = "0x1000000000000000000000000000000000000005" as const;
const admin = privateKeyToAccount(process.env.LIST_ADMIN_KEY as `0x${string}`);
const wallet = createWalletClient({
account: admin,
transport: http(process.env.MAROO_RPC_URL),
});
// TODO: replace with the real list id returned by createAddressList.
const listId = 12n;
// TODO: replace with the real addresses before production.
const toAdd = [
"0x8f3ac2b1d9e74c05a6b18fe27dc4913e5a0f7b62",
"0x3a9c71e4b8d2f6a05c7e19b4d3f82a6c5e0b9d47",
] as const;
const toRemove = [
"0x5ab7c1e40b8da46f9c7e29d3fa614e97b8f0ac21",
] as const;
await wallet.writeContract({
address: PCL,
abi: iPclAbi,
functionName: "updateAddressList",
args: [listId, toAdd, toRemove],
}); Solidity에서 저수준 호출
IPcl(PCL).updateAddressList(...)를 고수준으로 호출하면 프리컴파일에 바이트코드가 없기 때문에 빈 데이터로 revert됩니다(반환값이 없는 함수에 대해 solc가 코드 크기를 검사합니다). changeAddressListAdmin, setAddressListStatus처럼 반환값이 없는 PCL 메서드는 모두 같은 저수준 패턴으로 호출합니다. createAddressList는 새 listId를 반환하므로 일반 호출 문법을 그대로 씁니다.
// SPDX-License-Identifier: Apache-2.0
pragma solidity ^0.8.28;
import { IPcl } from "@maroo-chain/contracts/precompiles/pcl/IPcl.sol";
contract ListUpdater {
address constant PCL = 0x1000000000000000000000000000000000000005;
address public immutable owner;
error NotOwner();
constructor() { owner = msg.sender; }
/// @dev This contract is the list's admin, so PCL checks THIS contract, not its caller —
/// without the owner check anyone could change the list through it.
modifier onlyOwner() {
if (msg.sender != owner) revert NotOwner();
_;
}
/// @notice The PCL precompile has no EVM bytecode, so solc's extcodesize
/// check reverts a high-level call to a function that returns
/// nothing. Route updateAddressList through a low-level call and
/// bubble the revert data on failure.
function addMembers(uint64 listId, address[] calldata toAdd) external onlyOwner {
address[] memory toRemove = new address[](0);
(bool ok, bytes memory ret) = PCL.call(
abi.encodeCall(IPcl.updateAddressList, (listId, toAdd, toRemove))
);
if (!ok) {
assembly { revert(add(ret, 32), mload(ret)) }
}
}
}