@nexus-cross/pop 1.4.0-beta.1 → 1.4.0-beta.3

package/dist/adapters/index.d.ts

@@ -1,5 +1,5 @@
-import { C as CryptoPort, g as Secret, u as SecretHash, H as Hex, A as Address, d as ClaimSignerPort, S as SafeDropChainPort, n as OnePopDrop, I as Id, k as DropState, a as SafeDropApiPort, v as SocialIdentifier, O as OAuthProof, i as DropInbox, E as Envelope, L as LeaderboardEntry, o as PopEventName, m as HistoryPage, X as XConnection, h as BatchClaimSignature, p as SafeDrop } from '../createSafeDrop-BSO9RQBD.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,15 +69,11 @@ 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);
     getDropByKey(dropKey: Hex): Promise<OnePopDrop | null>;
-    getDropKeyByClaimAddress(claimAddress: Address, sponsor?: Address): Promise<Hex | null>;
+    getDropKeyByClaimAddress(claimAddress: Address, sponsor: Address): Promise<Hex | null>;
     getPendingDropsById(params: {
         id: Id;
     }): Promise<readonly OnePopDrop[]>;
@@ -83,33 +83,13 @@ declare class ViemSafeDropChainAdapter implements SafeDropChainPort {
     getPendingDropsBySponsor(params: {
         sponsor: Address;
     }): Promise<readonly OnePopDrop[]>;
-    /**
-     * 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을 채운다. */
+    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;
-        token: Address;
-        amount: bigint;
-        id: Id;
-        secretHash: SecretHash;
-    }): Promise<{
-        txHash: Hex;
-    }>;
     /**
      * permit 예치. approve tx 없이 typed-data 서명 1회 + deposit tx 1회.
      * 이 배포본의 deposit에는 token 인자가 없다 — 컨트랙트가 token()으로 고정한다.
@@ -129,20 +109,13 @@ declare class ViemSafeDropChainAdapter implements SafeDropChainPort {
      * 토큰에서 ecrecover가 조용히 실패해 deposit 내부 revert로만 드러난다.
      */
     private permitDomain;
-    withdraw(params: {
-        claimKey: Hex;
-        recipient: Address;
-        id: Id;
-        salt: Hex;
-        signature: Hex;
-        secret: Secret;
-    }): Promise<Hex>;
     withdrawUnmapped(params: {
         claimKey: Hex;
         recipient: Address;
         id: Id;
         dropKey: Hex;
         secret: Secret;
+        signature?: Hex;
         onSubmitted?: (txHash: Hex) => void | Promise<void>;
     }): Promise<Hex>;
     withdrawMapped(params: {
@@ -152,6 +125,20 @@ declare class ViemSafeDropChainAdapter implements SafeDropChainPort {
     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: {
         id: Id;
@@ -167,38 +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;
-    }): Promise<Hex>;
-    refundByKey(params: {
-        dropKey: Hex;
-    }): Promise<Hex>;
-    getChangeNonce(params: {
+    cancelRecipientChange(params: {
         id: Id;
-    }): Promise<bigint>;
+    }): 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;
@@ -206,9 +192,8 @@ declare class ViemSafeDropChainAdapter implements SafeDropChainPort {
 }
 
 /**
- * one-pop-api 엔드포인트 — 패키지 내부 상수. onramp/adapters/endpoints.ts와
- * 동일한 컨벤션(Vite import.meta.env + Next literal process.env, override →
- * 환경 식별 → 기본 URL, https 검증)을 따른다.
+ * ONEpop 배포 설정 — API와 컨트랙트 주소를 동일한 환경 식별자로 선택한다.
+ * Vite import.meta.env + Next literal process.env 컨벤션을 따른다.
  *
  * 우선순위 (override):
  *   1) `VITE_ONE_POP_API_BASE_URL` (Vite 빌드)
@@ -219,6 +204,22 @@ declare class ViemSafeDropChainAdapter implements SafeDropChainPort {
  * 스펙: packages/pop/src/infrastructure/openapi.json (basePath `/api`)
  */
 type PopEnvironment = 'dev' | 'stage' | 'production';
+interface PopContracts {
+    onePop: `0x${string}`;
+    permitErc20: `0x${string}`;
+    nft: `0x${string}`;
+    nftMinter: `0x${string}`;
+    validator: `0x${string}`;
+    feeRecipient: `0x${string}`;
+}
+interface PopDeployment {
+    apiBaseUrl: string;
+    contracts?: PopContracts;
+}
+/** ONEpop protocol fee: 5% (500 / 10,000 basis points). */
+declare const ONE_POP_FEE_BPS: bigint;
+declare const ONE_POP_BPS_DENOMINATOR: bigint;
+declare const ONE_POP_DEPLOYMENTS: Readonly<Record<PopEnvironment, PopDeployment>>;
 interface PopApiPaths {
     /** POST — 임시 claim 지갑 생성 (Bearer JWT). */
     createWallet: string;
@@ -232,766 +233,141 @@ interface PopApiPaths {
     envelopes: string;
     /** GET — 토큰별 pending 잔액 상위 (공개). */
     leaderboards: string;
-    /** GET — 내 온체인 이벤트 히스토리 (Bearer JWT). */
-    histories: string;
-    /** GET/POST/DELETE — X 연결 (Bearer JWT). */
-    xConnections: string;
-    /** POST — 일괄 수령 validator 서명 (Bearer JWT). */
-    batchClaimSignature: string;
-    /** GET — SSE 알림 스트림. pop은 구독하지 않는다(앱이 EventSource로 직접). */
-    eventsSubscribe: string;
-}
-declare const DEFAULT_POP_API_PATHS: PopApiPaths;
-/** 환경변수(override → 환경 식별)로 one-pop-api base URL을 결정한다. */
-declare function getOnePopApiBaseUrl(): string;
-/** 환경변수(override → 기본)로 cross-auth base URL을 결정한다. */
-declare function getCrossAuthBaseUrl(): string;
-
-/**
- * one-pop-api HTTP 어댑터. 스키마: packages/pop/src/infrastructure/openapi.json
- *   POST   /wallets                 (Bearer JWT)      → {address}
- *   POST   /wallets/private-key      (oauth_token 본문) → {address,private_key}
- *   GET    /drops                    (Bearer JWT)      → 수령 인박스
- *   GET    /envelopes                (공개)            → 카드 디자인
- *   GET    /leaderboards?token=      (공개)            → pending 상위
- *   GET    /histories                (Bearer JWT)      → 온체인 이벤트
- *   GET|POST|DELETE /x-connections   (Bearer JWT)      → X 연결
- *   POST   /batch-claim-signature    (Bearer JWT)      → ValidatorClaim 서명
- *
- * base URL은 미지정 시 환경변수로 결정(getOnePopApiBaseUrl).
- * wei-scale 값은 응답의 10진 문자열 → BigInt로 변환해 내보낸다(CLAUDE.md §4).
- */
-interface HttpSafeDropApiAdapterOptions {
-    /** 미지정 시 환경변수(VITE_/NEXT_PUBLIC_ONE_POP_*)로 결정. */
-    baseUrl?: string;
-    /** SIWE JWT 공급자. Bearer 인증이 필요한 모든 호출이 사용한다. */
-    getJwt?: () => string | undefined | Promise<string | undefined>;
-    /** 테스트/SSR용 fetch 주입. 기본 globalThis.fetch. */
-    fetchImpl?: typeof fetch;
-    /** 엔드포인트 경로 override. 기본 DEFAULT_POP_API_PATHS. */
-    paths?: Partial<PopApiPaths>;
-}
-declare class HttpSafeDropApiAdapter implements SafeDropApiPort {
-    private readonly baseUrl;
-    private readonly fetchImpl;
-    private readonly getJwt?;
-    private readonly paths;
-    constructor(options?: HttpSafeDropApiAdapterOptions);
-    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;
-    }>;
-    listDrops(params?: {
-        token?: Address;
-    }): Promise<DropInbox>;
-    listEnvelopes(params?: {
-        locale?: string;
-    }): Promise<readonly Envelope[]>;
-    getLeaderboard(params: {
-        token: Address;
-    }): Promise<readonly LeaderboardEntry[]>;
-    listHistories(params?: {
-        event?: PopEventName;
-        page?: number;
-        pageSize?: number;
-    }): Promise<HistoryPage>;
-    getXConnection(): Promise<XConnection | null>;
-    connectX(params: {
-        oauth: OAuthProof;
-    }): Promise<XConnection>;
-    disconnectX(): Promise<void>;
-    requestBatchClaimSignature(params: {
-        id: Id;
-        oauth: OAuthProof;
-        nonce: bigint;
-        deadline: bigint;
-    }): Promise<BatchClaimSignature>;
-    private request;
-}
-
-declare const SAFEDROP_ABI: readonly [{
-    readonly type: "constructor";
-    readonly inputs: readonly [{
-        readonly name: "claimPeriod_";
-        readonly type: "uint64";
-        readonly internalType: "uint64";
-    }];
-    readonly stateMutability: "nonpayable";
-}, {
-    readonly type: "function";
-    readonly name: "claimDigest";
-    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 outputs: readonly [{
-        readonly name: "";
-        readonly type: "bytes32";
-        readonly internalType: "bytes32";
-    }];
-    readonly stateMutability: "view";
-}, {
-    readonly type: "function";
-    readonly name: "claimPeriod";
-    readonly inputs: readonly [];
-    readonly outputs: readonly [{
-        readonly name: "";
-        readonly type: "uint64";
-        readonly internalType: "uint64";
-    }];
-    readonly stateMutability: "view";
-}, {
-    readonly type: "function";
-    readonly name: "claimedRecipientOf";
-    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: "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 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 stateMutability: "view";
-}, {
-    readonly type: "function";
-    readonly name: "drops";
-    readonly inputs: readonly [{
-        readonly name: "claimAddr";
-        readonly type: "address";
-        readonly internalType: "address";
-    }];
-    readonly outputs: readonly [{
-        readonly name: "sponsor";
-        readonly type: "address";
-        readonly internalType: "address";
-    }, {
-        readonly name: "recordIndex";
-        readonly type: "uint96";
-        readonly internalType: "uint96";
-    }, {
-        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: "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 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 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: "liveDropCountById";
-    readonly inputs: readonly [{
-        readonly name: "id";
-        readonly type: "string";
-        readonly internalType: "string";
-    }];
-    readonly outputs: readonly [{
-        readonly name: "";
-        readonly type: "uint256";
-        readonly internalType: "uint256";
-    }];
-    readonly stateMutability: "view";
-}, {
-    readonly type: "function";
-    readonly name: "liveDropsById";
-    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: "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 type: "uint96";
-            readonly internalType: "uint96";
-        }, {
-            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: "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 stateMutability: "view";
-}, {
-    readonly type: "function";
-    readonly name: "unclaimedDepositsOf";
-    readonly inputs: readonly [{
-        readonly name: "sponsor";
-        readonly type: "address";
-        readonly internalType: "address";
-    }];
-    readonly outputs: readonly [{
-        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 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: "unclaimedIndexesOf";
-    readonly inputs: readonly [{
-        readonly name: "sponsor";
-        readonly type: "address";
-        readonly internalType: "address";
-    }];
-    readonly outputs: readonly [{
-        readonly name: "";
-        readonly type: "uint256[]";
-        readonly internalType: "uint256[]";
-    }];
-    readonly stateMutability: "view";
-}, {
-    readonly type: "function";
-    readonly name: "withdraw";
-    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: "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 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 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 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: "id";
-        readonly type: "string";
-        readonly indexed: false;
-        readonly internalType: "string";
-    }, {
-        readonly name: "amount";
-        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: "id";
-        readonly type: "string";
-        readonly indexed: false;
-        readonly internalType: "string";
-    }, {
-        readonly name: "amount";
-        readonly type: "uint256";
-        readonly indexed: false;
-        readonly internalType: "uint256";
-    }];
-    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 type: "error";
-    readonly name: "ECDSAInvalidSignature";
-    readonly inputs: readonly [];
-}, {
-    readonly type: "error";
-    readonly name: "ECDSAInvalidSignatureLength";
-    readonly inputs: readonly [{
-        readonly name: "length";
-        readonly type: "uint256";
-        readonly internalType: "uint256";
-    }];
-}, {
-    readonly type: "error";
-    readonly name: "ECDSAInvalidSignatureS";
-    readonly inputs: readonly [{
-        readonly name: "s";
-        readonly type: "bytes32";
-        readonly internalType: "bytes32";
-    }];
-}, {
-    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 inputs: readonly [{
-        readonly name: "token";
-        readonly type: "address";
-        readonly internalType: "address";
-    }];
-}, {
-    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 inputs: readonly [{
-        readonly name: "str";
-        readonly type: "string";
-        readonly internalType: "string";
-    }];
-}, {
-    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 [];
-}];
+    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;
+}
+declare const DEFAULT_POP_API_PATHS: PopApiPaths;
+declare function getPopEnvironment(): PopEnvironment;
+declare function getOnePopDeployment(): PopDeployment;
+declare function getOnePopContracts(): PopContracts;
+/** 환경변수(override → 환경 식별)로 one-pop-api base URL을 결정한다. */
+declare function getOnePopApiBaseUrl(): string;
+/** 환경변수(override → 기본)로 cross-auth base URL을 결정한다. */
+declare function getCrossAuthBaseUrl(): string;
 
 /**
- * 일괄 수령(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 설명과 일치). 온체인 상한은 없고 가스가 한계다.
+ * one-pop-api HTTP 어댑터. 스키마: packages/pop/src/infrastructure/openapi.json
+ *   POST   /wallets                 (Bearer JWT)      → {address}
+ *   POST   /wallets/private-key      (oauth_token 본문) → {address,private_key}
+ *   GET    /drops                    (Bearer JWT)      → 수령 인박스
+ *   GET    /envelopes                (공개)            → 카드 디자인
+ *   GET    /leaderboards?token=      (공개)            → pending 상위
+ *   GET    /histories                (Bearer JWT)      → 온체인 이벤트
+ *   GET|POST|DELETE /x-connections   (Bearer JWT)      → X 연결
+ *   POST   /batch-claim-signature    (Bearer JWT)      → ValidatorClaim 서명
  *
- * EIP-712 (배포본 `eip712Domain()`으로 확인):
- *   domain = { name: 'ONEpop', version: '1', chainId, verifyingContract: SafeDrop }
- *   type   = ValidatorClaim(address recipient,string id,uint256 nonce,uint256 deadline)
- *   → digest는 `validatorClaimDigest()`가 온체인에서 그대로 돌려주므로, 로컬에서
- *     재조립하지 말고 그 값을 읽어 쓴다(백엔드와의 불일치를 가스 전에 잡는다).
+ * base URL은 미지정 시 환경변수로 결정(getOnePopApiBaseUrl).
+ * wei-scale 값은 응답의 10진 문자열 → BigInt로 변환해 내보낸다(CLAUDE.md §4).
  */
+interface HttpSafeDropApiAdapterOptions {
+    /** 미지정 시 환경변수(VITE_/NEXT_PUBLIC_ONE_POP_*)로 결정. */
+    baseUrl?: string;
+    /** SIWE JWT 공급자. Bearer 인증이 필요한 모든 호출이 사용한다. */
+    getJwt?: () => string | undefined | Promise<string | undefined>;
+    /** 테스트/SSR용 fetch 주입. 기본 globalThis.fetch. */
+    fetchImpl?: typeof fetch;
+    /** 엔드포인트 경로 override. 기본 DEFAULT_POP_API_PATHS. */
+    paths?: Partial<PopApiPaths>;
+}
+declare class HttpSafeDropApiAdapter implements SafeDropApiPort {
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    private readonly getJwt?;
+    private readonly paths;
+    constructor(options?: HttpSafeDropApiAdapterOptions);
+    createClaimWallet(params: {
+        sender: Address;
+        recipient: SocialIdentifier;
+    }): 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;
+    }>;
+    listDrops(params?: {
+        token?: Address;
+    }): Promise<DropInbox>;
+    listEnvelopes(params?: {
+        locale?: string;
+    }): Promise<readonly Envelope[]>;
+    getLeaderboard(params: {
+        token: Address;
+        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>;
+    getXConnection(): Promise<XConnection | null>;
+    connectX(params: {
+        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;
+        nonce: bigint;
+        deadline: bigint;
+    }): Promise<BatchClaimSignature>;
+    private request;
+}
+
+/** 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";
@@ -1031,41 +407,6 @@ declare const SAFEDROP_VALIDATOR_ABI: readonly [{
     readonly outputs: readonly [{
         readonly type: "uint256";
     }];
-}, {
-    readonly type: "function";
-    readonly name: "withdrawByValidator";
-    readonly stateMutability: "nonpayable";
-    readonly inputs: readonly [{
-        readonly name: "recipient";
-        readonly type: "address";
-    }, {
-        readonly name: "id";
-        readonly type: "string";
-    }, {
-        readonly name: "nonce";
-        readonly type: "uint256";
-    }, {
-        readonly name: "deadline";
-        readonly type: "uint256";
-    }, {
-        readonly name: "maxCount";
-        readonly type: "uint256";
-    }, {
-        readonly name: "signature";
-        readonly type: "bytes";
-    }];
-    readonly outputs: readonly [];
-}, {
-    readonly type: "function";
-    readonly name: "liveDropCountById";
-    readonly stateMutability: "view";
-    readonly inputs: readonly [{
-        readonly name: "id";
-        readonly type: "string";
-    }];
-    readonly outputs: readonly [{
-        readonly type: "uint256";
-    }];
 }, {
     readonly type: "function";
     readonly name: "claimedRecipientOf";
@@ -1093,6 +434,9 @@ declare const ONEPOP_ABI: readonly [{
     readonly name: "activeDropOf";
     readonly stateMutability: "view";
     readonly inputs: readonly [{
+        readonly name: "sponsor";
+        readonly type: "address";
+    }, {
         readonly name: "claimAddr";
         readonly type: "address";
     }];
@@ -1309,6 +653,39 @@ declare const ONEPOP_ABI: readonly [{
         readonly type: "bytes";
     }];
     readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "withdrawUnmappedBatchByKeys";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "recipient";
+        readonly type: "address";
+    }, {
+        readonly name: "id";
+        readonly type: "string";
+    }, {
+        readonly name: "anchorDropKey";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "signature";
+        readonly type: "bytes";
+    }, {
+        readonly name: "secret";
+        readonly type: "bytes";
+    }, {
+        readonly name: "nonce";
+        readonly type: "uint256";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }, {
+        readonly name: "dropKeys";
+        readonly type: "bytes32[]";
+    }, {
+        readonly name: "validatorSignature";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [];
 }, {
     readonly type: "function";
     readonly name: "withdrawMapped";
@@ -1327,6 +704,15 @@ declare const ONEPOP_ABI: readonly [{
         readonly type: "uint256";
     }];
     readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "batchWithdrawMapped";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "dropKeys";
+        readonly type: "bytes32[]";
+    }];
+    readonly outputs: readonly [];
 }, {
     readonly type: "function";
     readonly name: "refund";
@@ -1347,6 +733,57 @@ declare const ONEPOP_ABI: readonly [{
     readonly outputs: readonly [{
         readonly type: "uint256";
     }];
+}, {
+    readonly type: "function";
+    readonly name: "pendingRecipientChange";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "idKey";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "newRecipient";
+        readonly type: "address";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "requestRecipientChange";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        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";
+    }, {
+        readonly name: "nonce";
+        readonly type: "uint256";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }, {
+        readonly name: "validatorSignature";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "cancelRecipientChange";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "id";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [];
 }, {
     readonly type: "function";
     readonly name: "resetRecipient";
@@ -1365,6 +802,38 @@ declare const ONEPOP_ABI: readonly [{
         readonly type: "bytes";
     }];
     readonly outputs: readonly [];
+}, ...{
+    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: "length";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "ECDSAInvalidSignatureS";
+    readonly inputs: readonly [{
+        readonly name: "s";
+        readonly type: "bytes32";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "SafeERC20FailedOperation";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "StringTooLong";
+    readonly inputs: readonly [{
+        readonly name: "str";
+        readonly type: "string";
+    }];
 }];
 
 /**
@@ -1402,21 +871,18 @@ declare class CrossAuthClient {
 }
 
 interface CreateSafeDropClientOptions {
-    /** SafeDrop 컨트랙트 주소. */
-    contractAddress: Address;
+    /** SafeDrop 컨트랙트 주소. 미지정 시 ONE_POP_ENVIRONMENT 배포 설정. */
+    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 미지정 시 환경변수). */
@@ -1511,4 +977,4 @@ declare class XAuthClient {
     }>;
 }
 
-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 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, ONE_POP_BPS_DENOMINATOR, ONE_POP_DEPLOYMENTS, ONE_POP_FEE_BPS, type Pkce, type PopApiPaths, type PopContracts, type PopDeployment, type PopEnvironment, SAFEDROP_ABI, SAFEDROP_VALIDATOR_ABI, type SafeDropTransactionFees, type SessionStore, ViemClaimSignerAdapter, ViemCryptoAdapter, ViemSafeDropChainAdapter, type ViemSafeDropChainAdapterOptions, XAuthClient, type XAuthClientOptions, createSafeDropClient, generatePkce, generateState, getCrossAuthBaseUrl, getOnePopApiBaseUrl, getOnePopContracts, getOnePopDeployment, getPopEnvironment };