@nexus-cross/pop 1.3.10-beta.2 → 1.4.0-beta.2

package/dist/adapters/index.d.ts

@@ -1,5 +1,5 @@
-import { C as CryptoPort, g as Secret, t as SecretHash, H as Hex, A as Address, d as ClaimSignerPort, S as SafeDropChainPort, k as DropState, I as Id, a as SafeDropApiPort, u as SocialIdentifier, O as OAuthProof, i as DropInbox, E as Envelope, L as LeaderboardEntry, n as PopEventName, m as HistoryPage, X as XConnection, h as BatchClaimSignature, o as SafeDrop } from '../createSafeDrop-qoNG59jB.js';
-import { PublicClient, WalletClient, Chain, Transport } from 'viem';
+import { C as CryptoPort, g as Secret, z as SecretHash, H as Hex, A as Address, d as ClaimSignerPort, S as SafeDropChainPort, r as OnePopDrop, I as Id, k as DropState, a as SafeDropApiPort, F as SocialIdentifier, O as OAuthProof, i as DropInbox, E as Envelope, p as LeaderboardPage, q as MyLeaderboardEntry, o as HistoryType, m as HistoryPage, X as XConnection, s as RecipientChangeSignature, t as RecipientSignature, h as BatchClaimSignature, u as SafeDrop } from '../createSafeDrop-CayUX4w_.js';
+import { PublicClient, WalletClient, Chain, Transport, Abi } from 'viem';
 import { X as XAuthPort, a as XTokenResult } from '../XAuthPort-BNJePosj.js';
 
 /**
@@ -34,26 +34,30 @@ declare class ViemClaimSignerAdapter implements ClaimSignerPort {
     }): Promise<Hex>;
 }
 
+interface SafeDropTransactionFees {
+    /** 단건 write gas limit. */
+    gas?: bigint;
+    /** batch 고정 비용. */
+    batchBaseGas?: bigint;
+    /** batch 항목 1개당 추가 gas. */
+    batchGasPerDrop?: bigint;
+    /** batch gas limit 안전 상한. 초과하면 전송 전에 INVALID_PARAM. */
+    maxBatchGas?: bigint;
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+}
 interface ViemSafeDropChainAdapterOptions {
     address: Address;
     publicClient: PublicClient;
-    /** approve/deposit/refund 서명용 지갑(연결된 MetaMask 등). */
+    /** deposit/refund 서명용 지갑(연결된 MetaMask 등). */
     walletClient: WalletClient;
     chain: Chain;
     /** withdraw용 임시 지갑 client의 RPC transport. 기본 http()(chain.rpcUrls). */
     transport?: Transport;
-    /** withdraw gas/fee override. 기본 DEFAULT_WITHDRAW_GAS(gas-abstraction 대응). */
-    withdrawFees?: {
-        gas?: bigint;
-        maxFeePerGas?: bigint;
-        maxPriorityFeePerGas?: bigint;
-    };
-    /**
-     * true면 EIP-2612 permit 예치를 쓴다(approve tx 없음, 서명 1회 + tx 1회).
-     * 배포본마다 deposit 시그니처가 다르므로 opt-in이다 — permit deposit이 없는
-     * 컨트랙트에 켜면 셀렉터가 없어 revert한다. 토큰도 permit을 지원해야 한다.
-     */
-    permit?: boolean;
+    /** 모든 write의 EIP-1559/gas override. batch gas = base + perDrop × count. */
+    transactionFees?: SafeDropTransactionFees;
+    /** @deprecated Use transactionFees. */
+    withdrawFees?: SafeDropTransactionFees;
 }
 /**
  * SafeDrop 컨트랙트 어댑터 (viem). ABI: src/infrastructure/safedrop_abi.json.
@@ -65,58 +69,75 @@ declare class ViemSafeDropChainAdapter implements SafeDropChainPort {
     private readonly walletClient;
     private readonly chain;
     private readonly transport;
-    private readonly withdrawFees;
-    /**
-     * permit 옵션을 켠 경우에만 채워진다. DepositUseCase는 이 프로퍼티의 존재
-     * 여부로 approve tx를 건너뛸지 판단하므로, 미지원 배포본에서는 undefined여야 한다.
-     */
-    readonly depositWithPermit?: SafeDropChainPort['depositWithPermit'];
+    private readonly transactionFees;
+    readonly depositWithPermit: SafeDropChainPort['depositWithPermit'];
     constructor(options: ViemSafeDropChainAdapterOptions);
-    /**
-     * drops(claimAddr). 배포본에 따라 반환 필드가 8개(Foundry ABI) 또는 5개(permit
-     * 배포본)다 — 셀렉터가 같으므로 raw call 1회 후 디코딩만 나눈다. 8필드를 먼저
-     * 시도하는 이유: 짧은 데이터(5필드=192B)를 8필드로 읽으면 **에러가 나서** 안전하게
-     * 폴백되지만, 반대 순서면 8필드 데이터를 5필드로 조용히 오독한다.
-     */
-    getDrop(claimAddress: Address): Promise<DropState | null>;
-    /** 에스크로가 고정한 단일 ERC20. 5필드 배포본에서 drop.token을 채운다. */
+    getDropByKey(dropKey: Hex): Promise<OnePopDrop | null>;
+    getDropKeyByClaimAddress(claimAddress: Address, sponsor: Address): Promise<Hex | null>;
+    getPendingDropsById(params: {
+        id: Id;
+    }): Promise<readonly OnePopDrop[]>;
+    getPendingDropsByRecipient(params: {
+        recipient: Address;
+    }): Promise<readonly OnePopDrop[]>;
+    getPendingDropsBySponsor(params: {
+        sponsor: Address;
+    }): Promise<readonly OnePopDrop[]>;
+    getDrop(claimAddress: Address, sponsor: Address): Promise<DropState | null>;
     private escrowToken;
     getClaimDigest(params: {
         recipient: Address;
         id: Id;
-        salt: Hex;
-    }): Promise<Hex>;
-    approve(params: {
-        token: Address;
-        amount: bigint;
+        dropKey: Hex;
     }): Promise<Hex>;
-    deposit(params: {
-        claimAddress: Address;
+    /**
+     * permit 예치. approve tx 없이 typed-data 서명 1회 + deposit tx 1회.
+     * 이 배포본의 deposit에는 token 인자가 없다 — 컨트랙트가 token()으로 고정한다.
+     */
+    private permitDeposit;
+    depositMapped(params: {
         token: Address;
         amount: bigint;
         id: Id;
-        secretHash: SecretHash;
+        onSubmitted?: (txHash: Hex) => void | Promise<void>;
     }): Promise<{
         txHash: Hex;
     }>;
-    /**
-     * permit 예치. approve tx 없이 typed-data 서명 1회 + deposit tx 1회.
-     * 이 배포본의 deposit에는 token 인자가 없다 — 컨트랙트가 token()으로 고정한다.
-     */
-    private permitDeposit;
     /**
      * permit 서명 도메인. EIP-5267 eip712Domain()이 있으면 그 값을 쓰고, 없으면
      * name() + version '1'로 폴백한다. version을 상수로 박으면 다른 버전을 쓰는
      * 토큰에서 ecrecover가 조용히 실패해 deposit 내부 revert로만 드러난다.
      */
     private permitDomain;
-    withdraw(params: {
+    withdrawUnmapped(params: {
         claimKey: Hex;
         recipient: Address;
         id: Id;
-        salt: Hex;
-        signature: Hex;
+        dropKey: Hex;
+        secret: Secret;
+        signature?: Hex;
+        onSubmitted?: (txHash: Hex) => void | Promise<void>;
+    }): Promise<Hex>;
+    withdrawMapped(params: {
+        dropKey: Hex;
+        onSubmitted?: (txHash: Hex) => void | Promise<void>;
+    }): Promise<Hex>;
+    batchWithdrawMapped(params: {
+        count: number;
+    }): Promise<Hex>;
+    batchWithdrawMappedByKeys(params: {
+        dropKeys: readonly Hex[];
+    }): Promise<Hex>;
+    withdrawUnmappedBatchByKeys(params: {
+        claimKey: Hex;
+        recipient: Address;
+        id: Id;
+        anchorDropKey: Hex;
         secret: Secret;
+        nonce: bigint;
+        deadline: bigint;
+        dropKeys: readonly Hex[];
+        validatorSignature: Hex;
     }): Promise<Hex>;
     /** validatorNonceById는 **bytes32(id 해시)** 로 키잉된다 — 원문 string이 아니다. */
     getValidatorNonce(params: {
@@ -133,26 +154,37 @@ declare class ViemSafeDropChainAdapter implements SafeDropChainPort {
     getClaimedRecipient(params: {
         id: Id;
     }): Promise<Address>;
-    getLiveDropCount(params: {
+    refundByKey(params: {
+        dropKey: Hex;
+    }): Promise<Hex>;
+    getChangeNonce(params: {
         id: Id;
     }): Promise<bigint>;
-    /**
-     * 개별 withdraw와 달리 **연결된 수령인 지갑**이 보낸다 — 컨트랙트가 msg.sender와
-     * 서명의 recipient를 대조하므로 임시 claim 지갑으로는 보낼 수 없다(가스 대납 대상도 아님).
-     * simulate를 먼저 돌려 `ValidatorSigExpired`/`InvalidValidatorNonce`/
-     * `ECDSAInvalidSignature`를 이름으로 드러낸다.
-     */
-    withdrawByValidator(params: {
-        recipient: Address;
+    getPendingRecipientChange(params: {
+        id: Id;
+    }): Promise<Address>;
+    requestRecipientChange(params: {
+        id: Id;
+        newRecipient: Address;
+    }): Promise<Hex>;
+    completeRecipientChange(params: {
         id: Id;
         nonce: bigint;
         deadline: bigint;
-        maxCount: number;
         signature: Hex;
     }): Promise<Hex>;
-    refund(params: {
-        claimAddress: Address;
+    cancelRecipientChange(params: {
+        id: Id;
+    }): Promise<Hex>;
+    resetRecipient(params: {
+        id: Id;
+        nonce: bigint;
+        deadline: bigint;
+        signature: Hex;
     }): Promise<Hex>;
+    private currentContractWrite;
+    private transactionOverrides;
+    private batchTransactionOverrides;
     private sponsorWrite;
     private confirm;
     private recoverRevertName;
@@ -176,6 +208,8 @@ type PopEnvironment = 'dev' | 'stage' | 'production';
 interface PopApiPaths {
     /** POST — 임시 claim 지갑 생성 (Bearer JWT). */
     createWallet: string;
+    /** POST — tx hash에 메시지/봉투 메타데이터 연결 (Bearer JWT). */
+    dropMetadata: string;
     /** POST — pending 지갑 개인키 수령 (X OAuth 토큰). */
     retrievePrivateKey: string;
     /** GET — 수령 대기 인박스 (Bearer JWT + 활성 X 연결). */
@@ -184,12 +218,17 @@ interface PopApiPaths {
     envelopes: string;
     /** GET — 토큰별 pending 잔액 상위 (공개). */
     leaderboards: string;
+    leaderboardMe: string;
     /** GET — 내 온체인 이벤트 히스토리 (Bearer JWT). */
     histories: string;
     /** GET/POST/DELETE — X 연결 (Bearer JWT). */
     xConnections: string;
     /** POST — 일괄 수령 validator 서명 (Bearer JWT). */
     batchClaimSignature: string;
+    feedbacks: string;
+    revealYou: string;
+    recipientChangeSignature: string;
+    recipientResetSignature: string;
     /** GET — SSE 알림 스트림. pop은 구독하지 않는다(앱이 EventSource로 직접). */
     eventsSubscribe: string;
 }
@@ -232,15 +271,24 @@ declare class HttpSafeDropApiAdapter implements SafeDropApiPort {
     createClaimWallet(params: {
         sender: Address;
         recipient: SocialIdentifier;
-        message?: string;
-        envelopeId?: string;
     }): Promise<{
         claimAddress: Address;
+        id: Id;
+        isMapped: boolean;
     }>;
+    recordDropMetadata(params: {
+        txHash: Hex;
+        message?: string;
+        envelopeId?: string;
+    }): Promise<void>;
     retrieveClaimKey(params: {
+        claimAddress: Address;
         senderAddress: Address;
         oauth: OAuthProof;
     }): Promise<{
+        isMapped: true;
+    } | {
+        isMapped: false;
         claimKey: Hex;
         claimAddress: Address;
     }>;
@@ -252,9 +300,16 @@ declare class HttpSafeDropApiAdapter implements SafeDropApiPort {
     }): Promise<readonly Envelope[]>;
     getLeaderboard(params: {
         token: Address;
-    }): Promise<readonly LeaderboardEntry[]>;
-    listHistories(params?: {
-        event?: PopEventName;
+        page?: number;
+        pageSize?: number;
+        identifier?: string;
+    }): Promise<LeaderboardPage>;
+    getMyLeaderboardEntry(params: {
+        token: Address;
+    }): Promise<MyLeaderboardEntry>;
+    listHistories(params: {
+        type: HistoryType;
+        token?: Address;
         page?: number;
         pageSize?: number;
     }): Promise<HistoryPage>;
@@ -263,6 +318,25 @@ declare class HttpSafeDropApiAdapter implements SafeDropApiPort {
         oauth: OAuthProof;
     }): Promise<XConnection>;
     disconnectX(): Promise<void>;
+    submitFeedback(params: {
+        dropId: number;
+        message: string;
+    }): Promise<string>;
+    setRevealYou(params: {
+        revealYou: boolean;
+    }): Promise<boolean>;
+    requestRecipientChangeSignature(params: {
+        id: Id;
+        oauth: OAuthProof;
+        nonce: bigint;
+        deadline: bigint;
+    }): Promise<RecipientChangeSignature>;
+    requestRecipientResetSignature(params: {
+        id: Id;
+        oauth: OAuthProof;
+        nonce: bigint;
+        deadline: bigint;
+    }): Promise<RecipientSignature>;
     requestBatchClaimSignature(params: {
         id: Id;
         oauth: OAuthProof;
@@ -272,683 +346,404 @@ declare class HttpSafeDropApiAdapter implements SafeDropApiPort {
     private request;
 }
 
-declare const SAFEDROP_ABI: readonly [{
-    readonly type: "constructor";
-    readonly inputs: readonly [{
-        readonly name: "claimPeriod_";
-        readonly type: "uint64";
-        readonly internalType: "uint64";
+/** Full current ONEpop ABI, sourced directly from the bundled artifact. */
+declare const SAFEDROP_ABI: Abi;
+
+/** Validator reads and errors used by the current batch flow. */
+declare const SAFEDROP_VALIDATOR_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "validator";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "address";
     }];
-    readonly stateMutability: "nonpayable";
 }, {
     readonly type: "function";
-    readonly name: "claimDigest";
+    readonly name: "validatorClaimDigest";
+    readonly stateMutability: "view";
     readonly inputs: readonly [{
         readonly name: "recipient";
         readonly type: "address";
-        readonly internalType: "address";
     }, {
         readonly name: "id";
         readonly type: "string";
-        readonly internalType: "string";
     }, {
-        readonly name: "salt";
-        readonly type: "bytes32";
-        readonly internalType: "bytes32";
+        readonly name: "nonce";
+        readonly type: "uint256";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
     }];
     readonly outputs: readonly [{
-        readonly name: "";
         readonly type: "bytes32";
-        readonly internalType: "bytes32";
     }];
-    readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "claimPeriod";
-    readonly inputs: readonly [];
+    readonly name: "validatorNonceById";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "idHash";
+        readonly type: "bytes32";
+    }];
     readonly outputs: readonly [{
-        readonly name: "";
-        readonly type: "uint64";
-        readonly internalType: "uint64";
+        readonly type: "uint256";
     }];
-    readonly stateMutability: "view";
 }, {
     readonly type: "function";
     readonly name: "claimedRecipientOf";
+    readonly stateMutability: "view";
     readonly inputs: readonly [{
         readonly name: "id";
         readonly type: "string";
-        readonly internalType: "string";
     }];
     readonly outputs: readonly [{
-        readonly name: "";
         readonly type: "address";
-        readonly internalType: "address";
     }];
-    readonly stateMutability: "view";
 }, {
-    readonly type: "function";
-    readonly name: "deposit";
-    readonly inputs: readonly [{
-        readonly name: "claimAddr";
-        readonly type: "address";
-        readonly internalType: "address";
-    }, {
-        readonly name: "token";
-        readonly type: "address";
-        readonly internalType: "contract IERC20";
-    }, {
-        readonly name: "amount";
-        readonly type: "uint256";
-        readonly internalType: "uint256";
-    }, {
-        readonly name: "id";
-        readonly type: "string";
-        readonly internalType: "string";
-    }, {
-        readonly name: "secretHash";
-        readonly type: "bytes32";
-        readonly internalType: "bytes32";
-    }];
-    readonly outputs: readonly [];
-    readonly stateMutability: "nonpayable";
+    readonly type: "error";
+    readonly name: "ValidatorSigExpired";
+    readonly inputs: readonly [];
 }, {
+    readonly type: "error";
+    readonly name: "InvalidValidatorNonce";
+    readonly inputs: readonly [];
+}];
+
+/** Current ONEpop mapped/unmapped deployment ABI used by the SDK. */
+declare const ONEPOP_ABI: readonly [{
     readonly type: "function";
-    readonly name: "depositCountOf";
-    readonly inputs: readonly [{
-        readonly name: "sponsor";
-        readonly type: "address";
-        readonly internalType: "address";
-    }];
-    readonly outputs: readonly [{
-        readonly name: "";
-        readonly type: "uint256";
-        readonly internalType: "uint256";
-    }];
+    readonly name: "activeDropOf";
     readonly stateMutability: "view";
-}, {
-    readonly type: "function";
-    readonly name: "depositsBySponsor";
     readonly inputs: readonly [{
         readonly name: "sponsor";
         readonly type: "address";
-        readonly internalType: "address";
     }, {
-        readonly name: "";
-        readonly type: "uint256";
-        readonly internalType: "uint256";
-    }];
-    readonly outputs: readonly [{
         readonly name: "claimAddr";
         readonly type: "address";
-        readonly internalType: "address";
-    }, {
-        readonly name: "token";
-        readonly type: "address";
-        readonly internalType: "contract IERC20";
-    }, {
-        readonly name: "amount";
-        readonly type: "uint128";
-        readonly internalType: "uint128";
-    }, {
-        readonly name: "expiry";
-        readonly type: "uint64";
-        readonly internalType: "uint64";
-    }, {
-        readonly name: "secretHash";
-        readonly type: "bytes32";
-        readonly internalType: "bytes32";
-    }, {
-        readonly name: "id";
-        readonly type: "string";
-        readonly internalType: "string";
-    }];
-    readonly stateMutability: "view";
-}, {
-    readonly type: "function";
-    readonly name: "depositsOf";
-    readonly inputs: readonly [{
-        readonly name: "sponsor";
-        readonly type: "address";
-        readonly internalType: "address";
     }];
     readonly outputs: readonly [{
-        readonly name: "";
-        readonly type: "tuple[]";
-        readonly internalType: "struct SafeDrop.DepositRecord[]";
-        readonly components: readonly [{
-            readonly name: "claimAddr";
-            readonly type: "address";
-            readonly internalType: "address";
-        }, {
-            readonly name: "token";
-            readonly type: "address";
-            readonly internalType: "contract IERC20";
-        }, {
-            readonly name: "amount";
-            readonly type: "uint128";
-            readonly internalType: "uint128";
-        }, {
-            readonly name: "expiry";
-            readonly type: "uint64";
-            readonly internalType: "uint64";
-        }, {
-            readonly name: "secretHash";
-            readonly type: "bytes32";
-            readonly internalType: "bytes32";
-        }, {
-            readonly name: "id";
-            readonly type: "string";
-            readonly internalType: "string";
-        }];
+        readonly type: "bytes32";
     }];
-    readonly stateMutability: "view";
 }, {
     readonly type: "function";
     readonly name: "drops";
+    readonly stateMutability: "view";
     readonly inputs: readonly [{
-        readonly name: "claimAddr";
-        readonly type: "address";
-        readonly internalType: "address";
+        readonly name: "dropKey";
+        readonly type: "bytes32";
     }];
     readonly outputs: readonly [{
         readonly name: "sponsor";
         readonly type: "address";
-        readonly internalType: "address";
     }, {
-        readonly name: "recordIndex";
+        readonly name: "amount";
         readonly type: "uint96";
-        readonly internalType: "uint96";
     }, {
-        readonly name: "token";
+        readonly name: "claimAddr";
         readonly type: "address";
-        readonly internalType: "contract IERC20";
-    }, {
-        readonly name: "amount";
-        readonly type: "uint128";
-        readonly internalType: "uint128";
     }, {
-        readonly name: "expiry";
-        readonly type: "uint64";
-        readonly internalType: "uint64";
+        readonly name: "recipient";
+        readonly type: "address";
     }, {
         readonly name: "secretHash";
         readonly type: "bytes32";
-        readonly internalType: "bytes32";
-    }, {
-        readonly name: "salt";
-        readonly type: "bytes32";
-        readonly internalType: "bytes32";
     }, {
         readonly name: "id";
         readonly type: "string";
-        readonly internalType: "string";
     }];
-    readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "eip712Domain";
+    readonly name: "token";
+    readonly stateMutability: "view";
     readonly inputs: readonly [];
     readonly outputs: readonly [{
-        readonly name: "fields";
-        readonly type: "bytes1";
-        readonly internalType: "bytes1";
-    }, {
-        readonly name: "name";
-        readonly type: "string";
-        readonly internalType: "string";
-    }, {
-        readonly name: "version";
-        readonly type: "string";
-        readonly internalType: "string";
-    }, {
-        readonly name: "chainId";
-        readonly type: "uint256";
-        readonly internalType: "uint256";
-    }, {
-        readonly name: "verifyingContract";
         readonly type: "address";
-        readonly internalType: "address";
-    }, {
-        readonly name: "salt";
-        readonly type: "bytes32";
-        readonly internalType: "bytes32";
-    }, {
-        readonly name: "extensions";
-        readonly type: "uint256[]";
-        readonly internalType: "uint256[]";
     }];
-    readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "liveClaimAddrsById";
+    readonly name: "claimDigest";
+    readonly stateMutability: "view";
     readonly inputs: readonly [{
+        readonly name: "recipient";
+        readonly type: "address";
+    }, {
         readonly name: "id";
         readonly type: "string";
-        readonly internalType: "string";
+    }, {
+        readonly name: "dropKey";
+        readonly type: "bytes32";
     }];
     readonly outputs: readonly [{
-        readonly name: "";
-        readonly type: "address[]";
-        readonly internalType: "address[]";
+        readonly type: "bytes32";
     }];
-    readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "liveDropCountById";
+    readonly name: "claimedRecipientOf";
+    readonly stateMutability: "view";
     readonly inputs: readonly [{
         readonly name: "id";
         readonly type: "string";
-        readonly internalType: "string";
     }];
     readonly outputs: readonly [{
-        readonly name: "";
-        readonly type: "uint256";
-        readonly internalType: "uint256";
+        readonly type: "address";
     }];
-    readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "liveDropsById";
+    readonly name: "pendingDropsByXid";
+    readonly stateMutability: "view";
     readonly inputs: readonly [{
         readonly name: "id";
         readonly type: "string";
-        readonly internalType: "string";
     }];
     readonly outputs: readonly [{
-        readonly name: "claimAddrs";
-        readonly type: "address[]";
-        readonly internalType: "address[]";
+        readonly name: "dropKeys";
+        readonly type: "bytes32[]";
     }, {
         readonly name: "records";
         readonly type: "tuple[]";
-        readonly internalType: "struct SafeDrop.Drop[]";
         readonly components: readonly [{
             readonly name: "sponsor";
             readonly type: "address";
-            readonly internalType: "address";
         }, {
-            readonly name: "recordIndex";
+            readonly name: "amount";
             readonly type: "uint96";
-            readonly internalType: "uint96";
         }, {
-            readonly name: "token";
+            readonly name: "claimAddr";
             readonly type: "address";
-            readonly internalType: "contract IERC20";
-        }, {
-            readonly name: "amount";
-            readonly type: "uint128";
-            readonly internalType: "uint128";
         }, {
-            readonly name: "expiry";
-            readonly type: "uint64";
-            readonly internalType: "uint64";
+            readonly name: "recipient";
+            readonly type: "address";
         }, {
             readonly name: "secretHash";
             readonly type: "bytes32";
-            readonly internalType: "bytes32";
-        }, {
-            readonly name: "salt";
-            readonly type: "bytes32";
-            readonly internalType: "bytes32";
         }, {
             readonly name: "id";
             readonly type: "string";
-            readonly internalType: "string";
         }];
     }];
-    readonly stateMutability: "view";
-}, {
-    readonly type: "function";
-    readonly name: "refund";
-    readonly inputs: readonly [{
-        readonly name: "claimAddr";
-        readonly type: "address";
-        readonly internalType: "address";
-    }];
-    readonly outputs: readonly [];
-    readonly stateMutability: "nonpayable";
 }, {
     readonly type: "function";
-    readonly name: "unclaimedCountOf";
-    readonly inputs: readonly [{
-        readonly name: "sponsor";
-        readonly type: "address";
-        readonly internalType: "address";
-    }];
-    readonly outputs: readonly [{
-        readonly name: "";
-        readonly type: "uint256";
-        readonly internalType: "uint256";
-    }];
+    readonly name: "pendingDropsByRecipient";
     readonly stateMutability: "view";
-}, {
-    readonly type: "function";
-    readonly name: "unclaimedDepositsOf";
     readonly inputs: readonly [{
-        readonly name: "sponsor";
+        readonly name: "recipient";
         readonly type: "address";
-        readonly internalType: "address";
     }];
     readonly outputs: readonly [{
+        readonly name: "dropKeys";
+        readonly type: "bytes32[]";
+    }, {
         readonly name: "records";
         readonly type: "tuple[]";
-        readonly internalType: "struct SafeDrop.DepositRecord[]";
         readonly components: readonly [{
-            readonly name: "claimAddr";
-            readonly type: "address";
-            readonly internalType: "address";
-        }, {
-            readonly name: "token";
+            readonly name: "sponsor";
             readonly type: "address";
-            readonly internalType: "contract IERC20";
         }, {
             readonly name: "amount";
-            readonly type: "uint128";
-            readonly internalType: "uint128";
+            readonly type: "uint96";
+        }, {
+            readonly name: "claimAddr";
+            readonly type: "address";
         }, {
-            readonly name: "expiry";
-            readonly type: "uint64";
-            readonly internalType: "uint64";
+            readonly name: "recipient";
+            readonly type: "address";
         }, {
             readonly name: "secretHash";
             readonly type: "bytes32";
-            readonly internalType: "bytes32";
         }, {
             readonly name: "id";
             readonly type: "string";
-            readonly internalType: "string";
         }];
     }];
-    readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "unclaimedIndexesOf";
+    readonly name: "pendingDropsOf";
+    readonly stateMutability: "view";
     readonly inputs: readonly [{
         readonly name: "sponsor";
         readonly type: "address";
-        readonly internalType: "address";
     }];
     readonly outputs: readonly [{
-        readonly name: "";
-        readonly type: "uint256[]";
-        readonly internalType: "uint256[]";
+        readonly name: "dropKeys";
+        readonly type: "bytes32[]";
+    }, {
+        readonly name: "records";
+        readonly type: "tuple[]";
+        readonly components: readonly [{
+            readonly name: "sponsor";
+            readonly type: "address";
+        }, {
+            readonly name: "amount";
+            readonly type: "uint96";
+        }, {
+            readonly name: "claimAddr";
+            readonly type: "address";
+        }, {
+            readonly name: "recipient";
+            readonly type: "address";
+        }, {
+            readonly name: "secretHash";
+            readonly type: "bytes32";
+        }, {
+            readonly name: "id";
+            readonly type: "string";
+        }];
     }];
-    readonly stateMutability: "view";
 }, {
     readonly type: "function";
-    readonly name: "withdraw";
+    readonly name: "depositMapped";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "id";
+        readonly type: "string";
+    }, {
+        readonly name: "permitDeadline";
+        readonly type: "uint256";
+    }, {
+        readonly name: "v";
+        readonly type: "uint8";
+    }, {
+        readonly name: "r";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "s";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "withdrawUnmapped";
+    readonly stateMutability: "nonpayable";
     readonly inputs: readonly [{
         readonly name: "recipient";
         readonly type: "address";
-        readonly internalType: "address";
     }, {
         readonly name: "id";
         readonly type: "string";
-        readonly internalType: "string";
     }, {
-        readonly name: "salt";
+        readonly name: "dropKey";
         readonly type: "bytes32";
-        readonly internalType: "bytes32";
     }, {
         readonly name: "signature";
         readonly type: "bytes";
-        readonly internalType: "bytes";
     }, {
         readonly name: "secret";
         readonly type: "bytes";
-        readonly internalType: "bytes";
     }];
     readonly outputs: readonly [];
-    readonly stateMutability: "nonpayable";
 }, {
-    readonly type: "event";
-    readonly name: "Deposited";
+    readonly type: "function";
+    readonly name: "withdrawUnmappedBatchByKeys";
+    readonly stateMutability: "nonpayable";
     readonly inputs: readonly [{
-        readonly name: "claimAddr";
-        readonly type: "address";
-        readonly indexed: true;
-        readonly internalType: "address";
-    }, {
-        readonly name: "sponsor";
-        readonly type: "address";
-        readonly indexed: true;
-        readonly internalType: "address";
-    }, {
-        readonly name: "token";
+        readonly name: "recipient";
         readonly type: "address";
-        readonly indexed: true;
-        readonly internalType: "address";
-    }, {
-        readonly name: "amount";
-        readonly type: "uint256";
-        readonly indexed: false;
-        readonly internalType: "uint256";
     }, {
         readonly name: "id";
         readonly type: "string";
-        readonly indexed: false;
-        readonly internalType: "string";
     }, {
-        readonly name: "expiry";
-        readonly type: "uint64";
-        readonly indexed: false;
-        readonly internalType: "uint64";
-    }, {
-        readonly name: "secretHash";
+        readonly name: "anchorDropKey";
         readonly type: "bytes32";
-        readonly indexed: false;
-        readonly internalType: "bytes32";
-    }];
-    readonly anonymous: false;
-}, {
-    readonly type: "event";
-    readonly name: "EIP712DomainChanged";
-    readonly inputs: readonly [];
-    readonly anonymous: false;
-}, {
-    readonly type: "event";
-    readonly name: "Refunded";
-    readonly inputs: readonly [{
-        readonly name: "claimAddr";
-        readonly type: "address";
-        readonly indexed: true;
-        readonly internalType: "address";
     }, {
-        readonly name: "sponsor";
-        readonly type: "address";
-        readonly indexed: true;
-        readonly internalType: "address";
+        readonly name: "signature";
+        readonly type: "bytes";
     }, {
-        readonly name: "id";
-        readonly type: "string";
-        readonly indexed: false;
-        readonly internalType: "string";
+        readonly name: "secret";
+        readonly type: "bytes";
     }, {
-        readonly name: "amount";
+        readonly name: "nonce";
         readonly type: "uint256";
-        readonly indexed: false;
-        readonly internalType: "uint256";
-    }];
-    readonly anonymous: false;
-}, {
-    readonly type: "event";
-    readonly name: "Withdrawn";
-    readonly inputs: readonly [{
-        readonly name: "claimAddr";
-        readonly type: "address";
-        readonly indexed: true;
-        readonly internalType: "address";
-    }, {
-        readonly name: "recipient";
-        readonly type: "address";
-        readonly indexed: true;
-        readonly internalType: "address";
     }, {
-        readonly name: "sponsor";
-        readonly type: "address";
-        readonly indexed: true;
-        readonly internalType: "address";
+        readonly name: "deadline";
+        readonly type: "uint256";
     }, {
-        readonly name: "id";
-        readonly type: "string";
-        readonly indexed: false;
-        readonly internalType: "string";
+        readonly name: "dropKeys";
+        readonly type: "bytes32[]";
     }, {
-        readonly name: "amount";
-        readonly type: "uint256";
-        readonly indexed: false;
-        readonly internalType: "uint256";
+        readonly name: "validatorSignature";
+        readonly type: "bytes";
     }];
-    readonly anonymous: false;
-}, {
-    readonly type: "error";
-    readonly name: "AmountOverflow";
-    readonly inputs: readonly [];
-}, {
-    readonly type: "error";
-    readonly name: "DropAlreadyExists";
-    readonly inputs: readonly [];
-}, {
-    readonly type: "error";
-    readonly name: "DropExpired";
-    readonly inputs: readonly [];
-}, {
-    readonly type: "error";
-    readonly name: "DropNotExpired";
-    readonly inputs: readonly [];
-}, {
-    readonly type: "error";
-    readonly name: "DropNotFound";
-    readonly inputs: readonly [];
-}, {
-    readonly type: "error";
-    readonly name: "DuplicateDropForId";
-    readonly inputs: readonly [];
+    readonly outputs: readonly [];
 }, {
-    readonly type: "error";
-    readonly name: "ECDSAInvalidSignature";
-    readonly inputs: readonly [];
+    readonly type: "function";
+    readonly name: "withdrawMapped";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "dropKey";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [];
 }, {
-    readonly type: "error";
-    readonly name: "ECDSAInvalidSignatureLength";
+    readonly type: "function";
+    readonly name: "batchWithdrawMapped";
+    readonly stateMutability: "nonpayable";
     readonly inputs: readonly [{
-        readonly name: "length";
+        readonly name: "count";
         readonly type: "uint256";
-        readonly internalType: "uint256";
     }];
+    readonly outputs: readonly [];
 }, {
-    readonly type: "error";
-    readonly name: "ECDSAInvalidSignatureS";
+    readonly type: "function";
+    readonly name: "batchWithdrawMapped";
+    readonly stateMutability: "nonpayable";
     readonly inputs: readonly [{
-        readonly name: "s";
-        readonly type: "bytes32";
-        readonly internalType: "bytes32";
+        readonly name: "dropKeys";
+        readonly type: "bytes32[]";
     }];
+    readonly outputs: readonly [];
 }, {
-    readonly type: "error";
-    readonly name: "EmptyId";
-    readonly inputs: readonly [];
-}, {
-    readonly type: "error";
-    readonly name: "IdMismatch";
-    readonly inputs: readonly [];
-}, {
-    readonly type: "error";
-    readonly name: "InvalidShortString";
-    readonly inputs: readonly [];
-}, {
-    readonly type: "error";
-    readonly name: "NotSponsor";
-    readonly inputs: readonly [];
-}, {
-    readonly type: "error";
-    readonly name: "ReentrancyGuardReentrantCall";
-    readonly inputs: readonly [];
-}, {
-    readonly type: "error";
-    readonly name: "SafeERC20FailedOperation";
+    readonly type: "function";
+    readonly name: "refund";
+    readonly stateMutability: "nonpayable";
     readonly inputs: readonly [{
-        readonly name: "token";
-        readonly type: "address";
-        readonly internalType: "address";
+        readonly name: "dropKey";
+        readonly type: "bytes32";
     }];
+    readonly outputs: readonly [];
 }, {
-    readonly type: "error";
-    readonly name: "SaltMismatch";
-    readonly inputs: readonly [];
-}, {
-    readonly type: "error";
-    readonly name: "SecretMismatch";
-    readonly inputs: readonly [];
-}, {
-    readonly type: "error";
-    readonly name: "StringTooLong";
+    readonly type: "function";
+    readonly name: "changeNonceById";
+    readonly stateMutability: "view";
     readonly inputs: readonly [{
-        readonly name: "str";
-        readonly type: "string";
-        readonly internalType: "string";
+        readonly name: "idKey";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
     }];
 }, {
-    readonly type: "error";
-    readonly name: "ZeroAmount";
-    readonly inputs: readonly [];
-}, {
-    readonly type: "error";
-    readonly name: "ZeroClaimAddress";
-    readonly inputs: readonly [];
-}, {
-    readonly type: "error";
-    readonly name: "ZeroRecipient";
-    readonly inputs: readonly [];
-}, {
-    readonly type: "error";
-    readonly name: "ZeroToken";
-    readonly inputs: readonly [];
-}];
-
-/**
- * 일괄 수령(batch claim) ABI — **배포 바이트코드에서 검증한** as-built 기록.
- *
- * `src/infrastructure/safedrop_abi.json`(Foundry 산출물)에는 이 함수들이 없다.
- * 반대로 openapi.json 설명이 말하는 `validatorNonceById`는 **string이 아니라
- * bytes32(=keccak256(utf8(id)))** 를 받는다. 그래서 자동 생성 ABI를 믿지 않고
- * 배포본(CROSS testnet 612044 `0x50911242D9EA1554297ad11eb634230C56ae769c`)의
- * dispatcher 셀렉터로 직접 확인한 시그니처만 여기 둔다 (2026-07-30 검증):
- *
- *   3a5381b5 validator()
- *   aee5b003 validatorClaimDigest(address,string,uint256,uint256)
- *   dc4d9bff validatorNonceById(bytes32)          ← id는 **해시**로 키잉
- *   a730b8c5 withdrawByValidator(address,string,uint256,uint256,uint256,bytes)
- *   0d14a67d ValidatorSigExpired()
- *   dcf5a899 InvalidValidatorNonce()
- *
- * eth_call로 확인한 검증 순서: deadline → nonce → 서명(ECDSA).
- * `maxCount`는 **서명 대상이 아니다** — 그래서 서명 1건으로 페이지네이션을 계속
- * 재사용할 수 있다(openapi 설명과 일치). 온체인 상한은 없고 가스가 한계다.
- *
- * EIP-712 (배포본 `eip712Domain()`으로 확인):
- *   domain = { name: 'ONEpop', version: '1', chainId, verifyingContract: SafeDrop }
- *   type   = ValidatorClaim(address recipient,string id,uint256 nonce,uint256 deadline)
- *   → digest는 `validatorClaimDigest()`가 온체인에서 그대로 돌려주므로, 로컬에서
- *     재조립하지 말고 그 값을 읽어 쓴다(백엔드와의 불일치를 가스 전에 잡는다).
- */
-declare const SAFEDROP_VALIDATOR_ABI: readonly [{
     readonly type: "function";
-    readonly name: "validator";
+    readonly name: "pendingRecipientChange";
     readonly stateMutability: "view";
-    readonly inputs: readonly [];
+    readonly inputs: readonly [{
+        readonly name: "idKey";
+        readonly type: "bytes32";
+    }];
     readonly outputs: readonly [{
+        readonly name: "newRecipient";
         readonly type: "address";
     }];
 }, {
     readonly type: "function";
-    readonly name: "validatorClaimDigest";
-    readonly stateMutability: "view";
+    readonly name: "requestRecipientChange";
+    readonly stateMutability: "nonpayable";
     readonly inputs: readonly [{
-        readonly name: "recipient";
-        readonly type: "address";
+        readonly name: "id";
+        readonly type: "string";
     }, {
+        readonly name: "newRecipient";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "completeRecipientChange";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
         readonly name: "id";
         readonly type: "string";
     }, {
@@ -957,29 +752,25 @@ declare const SAFEDROP_VALIDATOR_ABI: readonly [{
     }, {
         readonly name: "deadline";
         readonly type: "uint256";
+    }, {
+        readonly name: "validatorSignature";
+        readonly type: "bytes";
     }];
-    readonly outputs: readonly [{
-        readonly type: "bytes32";
-    }];
+    readonly outputs: readonly [];
 }, {
     readonly type: "function";
-    readonly name: "validatorNonceById";
-    readonly stateMutability: "view";
+    readonly name: "cancelRecipientChange";
+    readonly stateMutability: "nonpayable";
     readonly inputs: readonly [{
-        readonly name: "idHash";
-        readonly type: "bytes32";
-    }];
-    readonly outputs: readonly [{
-        readonly type: "uint256";
+        readonly name: "id";
+        readonly type: "string";
     }];
+    readonly outputs: readonly [];
 }, {
     readonly type: "function";
-    readonly name: "withdrawByValidator";
+    readonly name: "resetRecipient";
     readonly stateMutability: "nonpayable";
     readonly inputs: readonly [{
-        readonly name: "recipient";
-        readonly type: "address";
-    }, {
         readonly name: "id";
         readonly type: "string";
     }, {
@@ -989,43 +780,42 @@ declare const SAFEDROP_VALIDATOR_ABI: readonly [{
         readonly name: "deadline";
         readonly type: "uint256";
     }, {
-        readonly name: "maxCount";
-        readonly type: "uint256";
-    }, {
-        readonly name: "signature";
+        readonly name: "validatorSignature";
         readonly type: "bytes";
     }];
     readonly outputs: readonly [];
-}, {
-    readonly type: "function";
-    readonly name: "liveDropCountById";
-    readonly stateMutability: "view";
+}, ...{
+    type: "error";
+    name: "AlreadyMapped" | "AmountOverflow" | "ChangeAlreadyRequested" | "ChangeInProgress" | "CountExceedsPending" | "DropAlreadyExists" | "DropNotFound" | "ECDSAInvalidSignature" | "EmptyId" | "IdMismatch" | "IdNotMapped" | "InvalidClaimSignature" | "InvalidShortString" | "InvalidValidatorNonce" | "InvalidValidatorSignature" | "NoPendingChange" | "NotRecipient" | "NotSponsor" | "PendingLimitExceeded" | "RecipientNotEmpty" | "ReentrancyGuardReentrantCall" | "SameRecipient" | "SecretMismatch" | "ValidatorSigExpired" | "ZeroAmount" | "ZeroClaimAddress" | "ZeroCount" | "ZeroRecipient" | "ZeroSbt" | "ZeroSecretHash" | "ZeroToken" | "ZeroValidator";
+    inputs: readonly [];
+}[], {
+    readonly type: "error";
+    readonly name: "ECDSAInvalidSignatureLength";
     readonly inputs: readonly [{
-        readonly name: "id";
-        readonly type: "string";
-    }];
-    readonly outputs: readonly [{
+        readonly name: "length";
         readonly type: "uint256";
     }];
 }, {
-    readonly type: "function";
-    readonly name: "claimedRecipientOf";
-    readonly stateMutability: "view";
+    readonly type: "error";
+    readonly name: "ECDSAInvalidSignatureS";
     readonly inputs: readonly [{
-        readonly name: "id";
-        readonly type: "string";
-    }];
-    readonly outputs: readonly [{
-        readonly type: "address";
+        readonly name: "s";
+        readonly type: "bytes32";
     }];
 }, {
     readonly type: "error";
-    readonly name: "ValidatorSigExpired";
-    readonly inputs: readonly [];
+    readonly name: "SafeERC20FailedOperation";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }];
 }, {
     readonly type: "error";
-    readonly name: "InvalidValidatorNonce";
-    readonly inputs: readonly [];
+    readonly name: "StringTooLong";
+    readonly inputs: readonly [{
+        readonly name: "str";
+        readonly type: "string";
+    }];
 }];
 
 /**
@@ -1066,18 +856,15 @@ interface CreateSafeDropClientOptions {
     /** SafeDrop 컨트랙트 주소. */
     contractAddress: Address;
     publicClient: PublicClient;
-    /** approve/deposit/refund 서명용 연결 지갑. */
+    /** deposit/refund 서명용 연결 지갑. */
     walletClient: WalletClient;
     chain: Chain;
     /** withdraw 임시 지갑 client의 RPC transport. */
     transport?: Transport;
-    /** withdraw gas/fee override (gas-abstraction). */
+    /** @deprecated Use transactionFees. */
     withdrawFees?: ViemSafeDropChainAdapterOptions['withdrawFees'];
-    /**
-     * true면 EIP-2612 permit 예치 — approve tx가 사라지고 서명 1회 + tx 1회가 된다.
-     * SafeDrop 배포본과 토큰 양쪽이 permit을 지원할 때만 켠다.
-     */
-    permit?: boolean;
+    /** 모든 contract write의 EIP-1559/gas override. */
+    transactionFees?: ViemSafeDropChainAdapterOptions['transactionFees'];
     /** 수령 링크 base URL. */
     claimBaseUrl: string;
     /** one-pop-api 어댑터 옵션(baseUrl 미지정 시 환경변수). */
@@ -1172,4 +959,4 @@ declare class XAuthClient {
     }>;
 }
 
-export { type CreateSafeDropClientOptions, CrossAuthClient, type CrossAuthClientOptions, DEFAULT_POP_API_PATHS, HttpSafeDropApiAdapter, type HttpSafeDropApiAdapterOptions, HttpXAuthAdapter, type HttpXAuthAdapterOptions, type Pkce, type PopApiPaths, type PopEnvironment, SAFEDROP_ABI, SAFEDROP_VALIDATOR_ABI, type SessionStore, ViemClaimSignerAdapter, ViemCryptoAdapter, ViemSafeDropChainAdapter, type ViemSafeDropChainAdapterOptions, XAuthClient, type XAuthClientOptions, createSafeDropClient, generatePkce, generateState, getCrossAuthBaseUrl, getOnePopApiBaseUrl };
+export { type CreateSafeDropClientOptions, CrossAuthClient, type CrossAuthClientOptions, DEFAULT_POP_API_PATHS, HttpSafeDropApiAdapter, type HttpSafeDropApiAdapterOptions, HttpXAuthAdapter, type HttpXAuthAdapterOptions, ONEPOP_ABI, type Pkce, type PopApiPaths, type PopEnvironment, SAFEDROP_ABI, SAFEDROP_VALIDATOR_ABI, type SafeDropTransactionFees, type SessionStore, ViemClaimSignerAdapter, ViemCryptoAdapter, ViemSafeDropChainAdapter, type ViemSafeDropChainAdapterOptions, XAuthClient, type XAuthClientOptions, createSafeDropClient, generatePkce, generateState, getCrossAuthBaseUrl, getOnePopApiBaseUrl };