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)) }
        }
    }
}
ESC
검색어를 입력하세요