IPcl.changeAddressListAdmin
changeAddressListAdmin(uint64 listId, address newAdmin) external 공유 주소 리스트의 관리 권한을 newAdmin에게 이관합니다. 현재 관리자만 호출할 수 있으며, 그 외 발신자는 Unauthorized로 revert됩니다. newAdmin을 0 주소로 지정하면 InvalidAddressListConfig로 거절됩니다. 이 진입점으로는 관리 권한 포기를 지원하지 않습니다. 이미 관리자인 주소를 다시 지정하면 아무 일도 일어나지 않고 이벤트도 발행되지 않습니다. 실제로 변경되면 레지스트리가 AddressListAdminChanged(listId, oldAdmin, newAdmin)를 발행하며, 이후 모든 상태 변경 호출(updateAddressList, setAddressListStatus, 추가 changeAddressListAdmin)은 newAdmin에서 와야 합니다.
파라미터
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
listId | uint64 | ✓ | 대상 리스트의 0이 아닌 ID입니다. 존재하지 않는 ID는 AddressListNotFound(listId)로, ID 0은 InvalidAddressListConfig(0)으로 revert됩니다. |
newAdmin | address | ✓ | 호출 이후 관리 권한을 보유할 주소입니다. 0 주소는 허용되지 않습니다. |
반환값
타입:
void 반환값은 없습니다. 이관 결과는 AddressListAdminChanged 이벤트로 확인합니다.
에러
| 코드 | 이름 | 설명 |
|---|---|---|
Unauthorized | Unauthorized | msg.sender가 listId의 현재 관리자가 아닐 때 revert됩니다. |
AddressListNotFound | AddressListNotFound | 해당 ID의 리스트가 존재하지 않을 때 revert됩니다(ID 0은 대신 InvalidAddressListConfig로 revert됩니다). AddressListNotFound(uint64 listId) 형태로 인코딩됩니다. |
InvalidAddressListConfig | InvalidAddressListConfig | newAdmin이 0 주소이거나 레지스트리에 저장된 메타데이터가 무결성 검사를 통과하지 못할 때 revert됩니다. InvalidAddressListConfig(uint64 listId) 형태로 인코딩됩니다. |
AddressListStorageError | AddressListStorageError | 하부 레지스트리 저장소를 읽거나 쓸 수 없을 때 revert됩니다. AddressListStorageError(uint64 listId) 형태로 인코딩됩니다. |
ABISetupFailed | ABISetupFailed | IPrecompile에서 상속됩니다. calldata를 프리컴파일 ABI로 디코딩할 수 없을 때 revert됩니다. |
예제
리스트 관리자를 멀티시그로 이관
이 트랜잭션이 블록에 포함된 뒤에는 listId에 대한 모든 상태 변경 호출이 multisig에서 와야 하며, 이전 키는 더 이상 리스트를 변경할 수 없습니다.
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 currentAdmin = privateKeyToAccount(process.env.LIST_ADMIN_KEY as `0x${string}`);
const wallet = createWalletClient({
account: currentAdmin,
transport: http(process.env.MAROO_RPC_URL),
});
// TODO: replace with the real list id and the multisig address before production.
const listId = 12n;
const multisig = "0x2c7f09b81a6d3ff1e5a0d4c6bc2a8f7e19dc3a4b";
await wallet.writeContract({
address: PCL,
abi: iPclAbi,
functionName: "changeAddressListAdmin",
args: [listId, multisig],
}); 클라이언트에서 이관 오류 디코드
전체 iPclAbi로 디코드하면 관리자 이관 오류와 IPrecompile에서 상속된 오류를 한 번에 처리할 수 있습니다. 직접 짧은 오류 목록을 만들지 않습니다.
import { BaseError, ContractFunctionRevertedError, decodeErrorResult } from "viem";
import { iPclAbi } from "@maroo-chain/contracts/abi/precompiles/pcl/IPcl";
try {
await wallet.writeContract({
address: PCL,
abi: iPclAbi,
functionName: "changeAddressListAdmin",
args: [listId, multisig],
});
} catch (err) {
const reverted = err instanceof BaseError
? err.walk((e) => e instanceof ContractFunctionRevertedError)
: null;
if (!(reverted instanceof ContractFunctionRevertedError) || !reverted.raw) {
// Not a contract revert (network, signing): rethrow.
throw err;
}
// iPclAbi carries both the list-specific errors (Unauthorized,
// AddressListNotFound, InvalidAddressListConfig, AddressListStorageError)
// and the inherited IPrecompile errors, so decodeErrorResult covers every case.
const decoded = decodeErrorResult({ abi: iPclAbi, data: reverted.raw });
console.error("changeAddressListAdmin reverted:", decoded.errorName, decoded.args);
}