@nexus-cross/pop 1.4.0-beta.5 → 2.4.0-beta.1

package/AGENTS.md

@@ -25,12 +25,19 @@ link's `#fragment` — the backend never sees it, so backend + link are each ins
 | Import | Contents | Requires |
 |---|---|---|
 | `@nexus-cross/pop` | domain types, use cases, pure utils, `createSafeDrop` | nothing |
-| `@nexus-cross/pop/adapters` | `createSafeDropClient`, viem/HTTP adapters, X OAuth, cross-auth | `viem`, `fetch` |
+| `@nexus-cross/pop/api` | HTTP clients only — `HttpSafeDropApiAdapter`, `CrossAuthClient`, X OAuth PKCE, base-URL helpers | `fetch` |
+| `@nexus-cross/pop/adapters` | everything in `/api` **plus** viem chain/signing adapters and `createSafeDropClient` | `viem`, `fetch` |
 | `@nexus-cross/pop/react` | `SafeDropProvider`, `useSafeDrop` | `react` |
 
 Default for an app: `createSafeDropClient` (adapters) + `SafeDropProvider` (react).
 `viem` and `react` are **optional peers** — install only what the chosen entry point needs.
 
+**Read-only consumer? Use `/api`, not `/adapters`.** The `/adapters` barrel
+statically imports the viem chain/signing adapters, so importing it just to call
+`/drops` or `/histories` drags `viem` into your bundle. `/api` is the fetch-only
+slice and needs no viem. Reach for `/adapters` when you actually sign or send
+transactions (deposit / withdraw / refund).
+
 ```sh
 pnpm add @nexus-cross/pop viem        # + react if using ./react
 ```
@@ -126,11 +133,11 @@ await safeDrop.withdraw({ recipient: myAddress, sponsor: sender!, claimAddress,
 ```ts
 await safeDrop.connectX({ oauth });          // required once before listDrops
 const conn = await safeDrop.getXConnection();  // null when not connected
-const inbox = await safeDrop.listDrops();      // { items, count, totalAmount, hasClaimedBefore }
+const inbox = await safeDrop.listDrops({ token: ERC20_ADDRESS });
 await safeDrop.rejectDrops(inbox.items.slice(0, 1).map((drop) => drop.id));
-const rejected = await safeDrop.listRejectedDrops(); // hidden pending drops
+const rejected = inbox.items.filter((drop) => drop.rejected); // flagged, excluded from totals
 const top = await safeDrop.getLeaderboard({ token: ERC20_ADDRESS, page: 1, pageSize: 10 });
-const page = await safeDrop.listHistories({ type: 'received', page: 1, pageSize: 20 });
+const page = await safeDrop.listHistories({ type: 'received', status: 'pending', rejected: false });
 await safeDrop.disconnectX();
 ```
 
@@ -225,7 +232,6 @@ The SDK does not wrap it — use `EventSource` directly. Delivery is best-effort
 | `getDrop` | `activeDropOf(claimAddr)` + `drops(dropKey)` | — |
 | `listDrops` | `GET /drops` | JWT + active X connection |
 | `rejectDrops` | `POST /drops/reject` | JWT + active X connection |
-| `listRejectedDrops` | `GET /drops/rejected` | JWT + active X connection |
 | `listEnvelopes` | `GET /envelopes` | public |
 | `getLeaderboard` | `GET /leaderboards?token=` | public |
 | `listHistories` | `GET /histories` | JWT |
@@ -257,7 +263,7 @@ Everything rejects with `SafeDropError` — branch on `err.code`, never on the m
 ## 9. Common mistakes
 
 - Converting `amount` to `Number` for display math → silent precision loss above ~0.009 ETH in wei.
-- Calling `listDrops()` before `connectX()` → `X_CONNECTION_NOT_FOUND`.
+- Calling `listDrops({ token })` before `connectX()` → `X_CONNECTION_NOT_FOUND`.
 - Passing the claim `secret` through a query parameter or logging it.
 - Building the claim link by hand instead of using the returned `withdrawLink` /
   `buildWithdrawLink` (the `#fragment` placement is load-bearing).

package/README.md

@@ -17,11 +17,19 @@ npm i @nexus-cross/pop viem   # react는 선택
 | import | 내용 | 의존 |
 |---|---|---|
 | `@nexus-cross/pop` | 도메인 타입, usecase, 순수 유틸, `createSafeDrop` facade | 없음 |
-| `@nexus-cross/pop/adapters` | viem/HTTP 어댑터, `createSafeDropClient`, X OAuth, cross-auth | viem, fetch |
+| `@nexus-cross/pop/api` | HTTP 클라이언트만 — `HttpSafeDropApiAdapter`, `CrossAuthClient`, X OAuth PKCE, base URL 헬퍼 | fetch |
+| `@nexus-cross/pop/adapters` | 위 전부 + viem 체인/서명 어댑터, `createSafeDropClient` | viem, fetch |
 | `@nexus-cross/pop/react` | `SafeDropProvider`, `useSafeDrop` | react |
 
 대부분의 앱은 **`createSafeDropClient`(adapters) + `SafeDropProvider`(react)** 만 쓰면 된다.
 
+**조회만 하는 소비자는 `/api` 를 쓴다.** `/adapters` 배럴은 viem 체인/서명
+어댑터를 static import 하므로, `/drops`·`/histories` 같은 읽기 전용 호출만
+필요한데 그 배럴을 쓰면 viem 이 딸려온다. `/api` 는 fetch 만 쓰는 부분을 떼어낸
+진입점이라 **viem 무의존**이다 (`@nexus-cross/connect-kit-react` 가 ONEpop
+summary 를 조회할 때 쓰는 경로 — 그 패키지는 의존성 정책상 viem 을 직접 쓸 수
+없다). deposit/withdraw/refund 처럼 서명·체인 호출이 필요하면 `/adapters`.
+
 ## 개념
 
 - **claimAddress** — 드롭당 임시 지갑 주소. `activeDropOf`로 현재 drop key를 찾는 데 사용.
@@ -153,18 +161,23 @@ await safeDrop.disconnectX();                 // idempotent
 // 내게 온 수령 대기 목록 (Bearer JWT + 활성 X 연결)
 const inbox = await safeDrop.listDrops({ token: '0x…ERC20' });
 // { items, count, totalAmount, hasClaimedBefore, mappedRecipient, pendingChangeTo }
-//   PendingDrop { id, dropKey, claimAddress, token, amount, message, envelopeId, depositedAt, sender }
+//   PendingDrop { id, dropKey, claimAddress, token, amount, message, envelopeId, depositedAt, rejected, sender }
 
-// 선택한 pending 드롭을 인박스에서 숨기고, 숨긴 목록을 다시 조회
+// 선택한 pending 드롭을 거절하면 items에는 rejected=true로 남고 count/totalAmount에서는 제외된다.
 const hiddenCount = await safeDrop.rejectDrops(inbox.items.slice(0, 2).map((drop) => drop.id));
-const hidden = await safeDrop.listRejectedDrops(); // { items, count }
 
 // 카드 디자인 · 리더보드 (공개 — JWT 불필요)
 const envelopes = await safeDrop.listEnvelopes({ locale: 'ko' });
 const top = await safeDrop.getLeaderboard({ token: '0x…ERC20', page: 1, pageSize: 10 });
 
 // 내 drop 히스토리
-const page = await safeDrop.listHistories({ type: 'received', page: 1, pageSize: 20 });
+const page = await safeDrop.listHistories({
+  type: 'received',
+  status: 'pending',
+  rejected: false,
+  page: 1,
+  pageSize: 20,
+});
 ```
 
 `inbox.hasClaimedBefore === false`면 **첫 수령은 개별 claim만** 가능하다 — 일괄 수령 CTA를 이 값으로 게이트한다.
@@ -304,7 +317,7 @@ base URL은 https(또는 `http://localhost`)만 허용한다. 프로토콜 수
 | `baseUrl` | `string` | 환경변수(`getOnePopApiBaseUrl`) | one-pop-api base URL |
 | `getJwt` | `() => string \| undefined \| Promise<…>` | — | **SIWE JWT.** deposit·`listDrops`·`listHistories`·`x-connections`·batch 서명에 필요. 미제공 시 요청 전에 `UNAUTHORIZED` |
 | `fetchImpl` | `typeof fetch` | `globalThis.fetch` | 테스트/SSR 주입 |
-| `paths` | `Partial<PopApiPaths>` | `DEFAULT_POP_API_PATHS` (`/wallets`, `/wallets/private-key`, `/drops`, `/drops/reject`, `/drops/rejected`, `/envelopes`, `/leaderboards`, `/histories`, `/x-connections`, `/batch-claim-signature`, `/events/subscribe`) | 엔드포인트 경로 override |
+| `paths` | `Partial<PopApiPaths>` | `DEFAULT_POP_API_PATHS` (`/wallets`, `/wallets/private-key`, `/drops`, `/drops/reject`, `/envelopes`, `/leaderboards`, `/histories`, `/x-connections`, `/batch-claim-signature`, `/events/subscribe`) | 엔드포인트 경로 override |
 
 ### `ViemSafeDropChainAdapter.transactionFees` 기본값
 

package/dist/{createSafeDrop-D23me-Z-.d.ts → SafeDropApiPort-BLewfSaK.d.ts}

@@ -157,6 +157,8 @@ interface PendingDrop {
     readonly envelopeId: string;
     /** RFC3339 문자열. */
     readonly depositedAt: string;
+    /** 인박스 합계에서는 제외되지만 items에는 남는 표시 전용 거절 상태. */
+    readonly rejected: boolean;
     readonly sender: DropSender;
 }
 /** GET /drops — 수령 대기 인박스 (Bearer JWT + 활성 X 연결 필요). */
@@ -170,11 +172,6 @@ interface DropInbox {
     readonly mappedRecipient: Address | null;
     readonly pendingChangeTo: Address | null;
 }
-/** GET /drops/rejected — 사용자가 숨긴 pending 드롭 목록. */
-interface RejectedDrops {
-    readonly items: readonly PendingDrop[];
-    readonly count: number;
-}
 /** GET /envelopes — 카드 디자인. 공개 엔드포인트. */
 interface Envelope {
     readonly id: string;
@@ -204,17 +201,22 @@ interface MyLeaderboardEntry extends Omit<LeaderboardEntry, 'rank'> {
     readonly rank: number | null;
 }
 type HistoryType = 'sent' | 'received';
+type HistoryStatus = 'pending' | 'claimed' | 'refunded';
 interface HistoryParty {
     readonly address: Address;
     readonly handle: string;
     readonly displayName: string;
     readonly profileImageUrl: string;
 }
+interface HistoryReceiverParty extends Omit<HistoryParty, 'address'> {
+    /** 미수령 상태에서는 아직 claiming wallet이 없다. */
+    readonly address: Address | null;
+}
 /** GET /histories의 drop 중심 항목. */
 interface HistoryEntry {
     readonly id: number;
     readonly type: HistoryType;
-    readonly status: string;
+    readonly status: HistoryStatus;
     readonly token: Address;
     readonly amount: bigint;
     readonly claimAddress: Address;
@@ -228,7 +230,7 @@ interface HistoryEntry {
     /** 수신자가 인박스에서 숨긴 드롭인지 여부. 온체인 status에는 영향이 없다. */
     readonly rejected: boolean;
     readonly sender: HistoryParty;
-    readonly receiver: HistoryParty;
+    readonly receiver: HistoryReceiverParty;
 }
 interface HistoryPage {
     readonly items: readonly HistoryEntry[];
@@ -259,27 +261,6 @@ interface RecipientChangeSignature extends RecipientSignature {
     readonly newRecipient: Address;
 }
 
-/**
- * 순수 계산이 아니라 외부 구현(해시 라이브러리/CSPRNG)이 필요한 암호 연산.
- * core는 keccak/난수 구현을 갖지 않으므로 Port로 분리한다.
- * 어댑터가 viem `keccak256`/`crypto.getRandomValues` 등으로 구현.
- */
-interface CryptoPort {
-    /** utf8(secret) → keccak256 → 0x-prefixed hex. 컨트랙트 secretHash와 일치해야 함. */
-    keccak256(input: Secret): SecretHash;
-    /** CSPRNG 기반 고엔트로피 secret 문구 생성. */
-    randomSecret(): Secret;
-    /**
-     * digest + 서명 → 서명자 주소. 백엔드 validator 서명을 **가스 쓰기 전에** 검증하는
-     * 용도(최종 관문은 여전히 컨트랙트다). optional — 미구현 어댑터에서는 사전 검증만
-     * 생략되고 플로우는 그대로 동작한다.
-     */
-    recoverAddress?(params: {
-        digest: Hex;
-        signature: Hex;
-    }): Promise<Address>;
-}
-
 /**
  * off-chain 백엔드(one-pop-api) 계약. 임시 claim 키 보관/전달, X 연결, 조회
  * 엔드포인트, validator 서명을 담당한다. 이 포트만으로는 자금을 옮길 수 없다
@@ -323,15 +304,14 @@ interface SafeDropApiPort {
         claimAddress: Address;
     }>;
     /** GET /drops — 내게 온 수령 대기 목록. Bearer JWT + 활성 X 연결 필요. */
-    listDrops?(params?: {
-        token?: Address;
+    listDrops?(params: {
+        token: Address;
+        dropKey?: Hex;
     }): Promise<DropInbox>;
     /** POST /drops/reject — 선택한 pending 드롭을 인박스에서 숨긴다. */
     rejectDrops?(params: {
         dropIds: readonly number[];
     }): Promise<number>;
-    /** GET /drops/rejected — 사용자가 숨긴 pending 드롭 목록. */
-    listRejectedDrops?(): Promise<RejectedDrops>;
     /** GET /envelopes — 카드 디자인 목록. 공개(인증 불필요). */
     listEnvelopes?(params?: {
         locale?: string;
@@ -350,6 +330,9 @@ interface SafeDropApiPort {
     listHistories?(params: {
         type: HistoryType;
         token?: Address;
+        status?: HistoryStatus;
+        /** received에서만 적용되며 sent에서는 서버가 무시한다. */
+        rejected?: boolean;
         /** 1-based (기본 1). */
         page?: number;
         /** 기본 20, 최대 100. */
@@ -397,291 +380,4 @@ interface SafeDropApiPort {
     }): Promise<BatchClaimSignature>;
 }
 
-/** Current ONEpop drop record, keyed by bytes32 rather than claim wallet. */
-interface OnePopDrop {
-    dropKey: Hex;
-    sponsor: Address;
-    amount: bigint;
-    claimAddress: Address;
-    recipient: Address;
-    secretHash: SecretHash;
-    id: Id;
-}
-interface DropState extends OnePopDrop {
-    /** ONEpop escrow is single-token; token() is contract-wide. */
-    token: Address;
-}
-/**
- * SafeDrop 컨트랙트 상호작용. 어댑터는 자신의 컨트랙트 주소를 알고 있으므로
- * approve의 spender 등은 받지 않는다. 쓰기는 receipt 확인 후 tx hash 반환.
- * withdraw는 임시 지갑이 직접 전송(가스 대납) — claimKey 필요.
- * ABI: src/infrastructure/safedrop_abi.json.
- */
-interface SafeDropChainPort {
-    getDropByKey(dropKey: Hex): Promise<OnePopDrop | null>;
-    getDropKeyByClaimAddress(claimAddress: Address, sponsor: Address): Promise<Hex | null>;
-    getClaimedRecipient(params: {
-        id: Id;
-    }): Promise<Address>;
-    getPendingDropsById(params: {
-        id: Id;
-    }): Promise<readonly OnePopDrop[]>;
-    getPendingDropsByRecipient(params: {
-        recipient: Address;
-    }): Promise<readonly OnePopDrop[]>;
-    getPendingDropsBySponsor(params: {
-        sponsor: Address;
-    }): Promise<readonly OnePopDrop[]>;
-    /** activeDropOf(claimAddr) → drops(dropKey). 없으면 null. */
-    getDrop(claimAddress: Address, sponsor: Address): Promise<DropState | null>;
-    /** claimDigest(recipient, id, dropKey) — 서명 대상 bytes32. */
-    getClaimDigest(params: {
-        recipient: Address;
-        id: Id;
-        dropKey: Hex;
-    }): Promise<Hex>;
-    /**
-     * EIP-2612 permit 예치 — 현재 ONEpop deposit의 유일한 형태다.
-     * 서명(typed data)·deadline·v/r/s는 전부 어댑터 내부 관심사다.
-     */
-    depositWithPermit(params: {
-        claimAddress: Address;
-        token: Address;
-        amount: bigint;
-        id: Id;
-        secretHash: SecretHash;
-        onSubmitted?: (txHash: Hex) => void | Promise<void>;
-    }): Promise<{
-        txHash: Hex;
-        dropKey: Hex;
-    }>;
-    depositMapped(params: {
-        token: Address;
-        amount: bigint;
-        id: Id;
-        onSubmitted?: (txHash: Hex) => void | Promise<void>;
-    }): Promise<{
-        txHash: Hex;
-        dropKey: 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: {
-        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>;
-    refundByKey(params: {
-        dropKey: Hex;
-    }): Promise<Hex>;
-    getChangeNonce(params: {
-        id: Id;
-    }): Promise<bigint>;
-    getPendingRecipientChange(params: {
-        id: Id;
-    }): Promise<Address>;
-    requestRecipientChange(params: {
-        id: Id;
-        newRecipient: Address;
-    }): Promise<Hex>;
-    completeRecipientChange(params: {
-        id: Id;
-        nonce: bigint;
-        deadline: bigint;
-        signature: Hex;
-    }): Promise<Hex>;
-    cancelRecipientChange(params: {
-        id: Id;
-    }): Promise<Hex>;
-    resetRecipient(params: {
-        id: Id;
-        nonce: bigint;
-        deadline: bigint;
-        signature: Hex;
-    }): Promise<Hex>;
-    /** validatorNonceById(keccak256(utf8(id))). id 해싱은 어댑터 책임. */
-    getValidatorNonce?(params: {
-        id: Id;
-    }): Promise<bigint>;
-    /**
-     * validatorClaimDigest(recipient, id, nonce, deadline) — 온체인 EIP-712 다이제스트.
-     * 로컬 재조립 대신 이 값을 읽어 백엔드 서명을 검증한다.
-     */
-    getValidatorClaimDigest?(params: {
-        recipient: Address;
-        id: Id;
-        nonce: bigint;
-        deadline: bigint;
-    }): Promise<Hex>;
-    /** validator() — 서명자여야 하는 주소. 백엔드 서명 검증의 기준값. */
-    getValidator?(): Promise<Address>;
-}
-
-/**
- * 임시 claim 키로 claimDigest(온체인에서 읽은 bytes32)에 raw ECDSA 서명을 만든다.
- * 컨트랙트가 claimDigest를 계산해주므로 로컬 EIP-712 typed data 구성은 불필요 —
- * digest를 그대로 서명한다. 서명은 브라우저 로컬, 백엔드 미관여.
- */
-interface ClaimSignerPort {
-    signDigest(params: {
-        claimKey: Hex;
-        digest: Hex;
-    }): Promise<Hex>;
-}
-
-/**
- * 프레임워크 무관 진입점. 포트 구현(어댑터)을 주입하면 usecase를 조립해 반환한다.
- *
- *   const safeDrop = createSafeDrop(
- *     { claimBaseUrl },
- *     { api, chain, signer, crypto },
- *   );
- *   const result = await safeDrop.deposit({ ... });
- *   if (!result.isMapped) sendLink(result.withdrawLink);
- *
- * viem/HTTP 어댑터를 자동 조립하려면 `@nexus-cross/pop/adapters`의
- * createSafeDropClient를 사용한다. (도메인/컨트랙트 주소는 chain 어댑터가 안다.)
- */
-
-interface SafeDropConfig {
-    /** 수령 링크 base URL. 예: https://one-pop.example/claim */
-    claimBaseUrl: string;
-}
-interface SafeDropDeps {
-    api: SafeDropApiPort;
-    chain: SafeDropChainPort;
-    signer: ClaimSignerPort;
-    crypto: CryptoPort;
-}
-interface SafeDrop {
-    readonly config: SafeDropConfig;
-    deposit(params: DepositParams): Promise<DepositResult>;
-    /** X OAuth 검증 후 (sender_address + 토큰 소유자)로 임시 claim 키/주소를 받는다 (point of return). */
-    retrieveClaimKey(params: {
-        claimAddress: Address;
-        senderAddress: Address;
-        oauth: OAuthProof;
-    }): Promise<{
-        isMapped: true;
-    } | {
-        isMapped: false;
-        claimKey: Hex;
-        claimAddress: Address;
-    }>;
-    withdraw(params: WithdrawParams): Promise<WithdrawResult>;
-    refund(params: RefundParams): Promise<RefundResult>;
-    /** activeDropOf(claimAddr)로 조회한 현재 온체인 드롭. */
-    getDrop(claimAddress: Address, sponsor: Address): Promise<DropState | null>;
-    getDropByKey(dropKey: Hex): Promise<OnePopDrop | null>;
-    getDropKeyByClaimAddress(claimAddress: Address, sponsor: Address): Promise<Hex | null>;
-    getClaimedRecipient(id: Id): Promise<Address>;
-    getPendingDropsById(id: Id): Promise<readonly OnePopDrop[]>;
-    getPendingDropsByRecipient(recipient: Address): Promise<readonly OnePopDrop[]>;
-    getPendingDropsBySponsor(sponsor: Address): Promise<readonly OnePopDrop[]>;
-    withdrawUnmapped(params: Parameters<SafeDropChainPort['withdrawUnmapped']>[0]): Promise<Hex>;
-    withdrawMapped(params: Parameters<SafeDropChainPort['withdrawMapped']>[0]): Promise<Hex>;
-    batchWithdrawMapped(count: number): Promise<Hex>;
-    batchWithdrawMappedByKeys(dropKeys: readonly Hex[]): Promise<Hex>;
-    refundByKey(dropKey: Hex): Promise<Hex>;
-    getChangeNonce(id: Id): Promise<bigint>;
-    getPendingRecipientChange(id: Id): Promise<Address>;
-    requestRecipientChange(id: Id, newRecipient: Address): Promise<Hex>;
-    completeRecipientChange(params: Parameters<SafeDropChainPort['completeRecipientChange']>[0]): Promise<Hex>;
-    cancelRecipientChange(id: Id): Promise<Hex>;
-    resetRecipient(params: Parameters<SafeDropChainPort['resetRecipient']>[0]): Promise<Hex>;
-    /** 내게 온 수령 대기 목록. Bearer JWT + 활성 X 연결 필요. */
-    listDrops(params?: {
-        token?: Address;
-    }): Promise<DropInbox>;
-    /** 선택한 pending 드롭을 인박스에서 숨긴다. */
-    rejectDrops(dropIds: readonly number[]): Promise<number>;
-    /** 사용자가 숨긴 pending 드롭 목록. */
-    listRejectedDrops(): Promise<RejectedDrops>;
-    /** 카드 디자인 목록 (공개). deposit의 `envelopeId`에 쓴다. */
-    listEnvelopes(params?: {
-        locale?: string;
-    }): Promise<readonly Envelope[]>;
-    /** 토큰별 pending 잔액 상위 (공개). */
-    getLeaderboard(params: {
-        token: Address;
-        page?: number;
-        pageSize?: number;
-        identifier?: string;
-    }): Promise<LeaderboardPage>;
-    getMyLeaderboardEntry(params: {
-        token: Address;
-    }): Promise<MyLeaderboardEntry>;
-    /** sent/received 드롭 히스토리. Bearer JWT 필요. */
-    listHistories(params: {
-        type: HistoryType;
-        token?: Address;
-        page?: number;
-        pageSize?: number;
-    }): Promise<HistoryPage>;
-    /** 활성 X 연결. 없으면 null. */
-    getXConnection(): Promise<XConnection | null>;
-    /** X 계정을 SIWE 지갑에 연결. `listDrops`의 선행 조건. */
-    connectX(params: {
-        oauth: OAuthProof;
-    }): Promise<XConnection>;
-    /** X 연결 해제 (idempotent). */
-    disconnectX(): Promise<void>;
-    submitFeedback(params: {
-        dropId: number;
-        message: string;
-    }): Promise<string>;
-    setRevealYou(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>;
-    /**
-     * anchor drop의 secret/claim key와 validator 서명을 함께 사용해 현재 pending key를
-     * 한 번에 수령한다.
-     */
-    batchClaim(params: BatchClaimParams): Promise<BatchClaimResult>;
-    /**
-     * 서명만 따로 받는 저수준 경로(직접 컨트랙트를 호출할 때). 대부분은 `batchClaim`을 쓴다.
-     * nonce는 `validatorNonceById(keccak256(utf8(id)))`에서 읽은 값이어야 한다.
-     */
-    requestBatchClaimSignature(params: {
-        id: Id;
-        oauth: OAuthProof;
-        nonce: bigint;
-        deadline: bigint;
-    }): Promise<BatchClaimSignature>;
-}
-declare function createSafeDrop(config: SafeDropConfig, deps: SafeDropDeps): SafeDrop;
-
-export { type Address as A, type BatchClaimParams as B, type CryptoPort as C, type DepositParams as D, type Envelope as E, type SecretHash as F, type SocialIdentifier as G, type Hex as H, type Id as I, type SocialProvider as J, createSafeDrop as K, type LeaderboardEntry as L, type MappedDepositResult as M, type OAuthProof as O, type PendingDrop as P, type RefundParams as R, type SafeDropChainPort as S, type UnmappedDepositResult as U, type WithdrawParams as W, type XConnection as X, type SafeDropApiPort as a, type DepositResult as b, type BatchClaimResult as c, type ClaimSignerPort as d, type WithdrawResult as e, type RefundResult as f, type Secret as g, type BatchClaimSignature as h, type DropInbox as i, type DropSender as j, type DropState as k, type HistoryEntry as l, type HistoryPage as m, type HistoryParty as n, type HistoryType as o, type LeaderboardPage as p, type MyLeaderboardEntry as q, type OnePopDrop as r, type RecipientChangeSignature as s, type RecipientSignature as t, type RejectedDrops as u, type SafeDrop as v, type SafeDropConfig as w, type SafeDropDeps as x, SafeDropError as y, type SafeDropErrorCode as z };
+export { type Address as A, type BatchClaimParams as B, type DepositParams as D, type Envelope as E, type Hex as H, type Id as I, type LeaderboardPage as L, type MyLeaderboardEntry as M, type OAuthProof as O, type PendingDrop as P, type RefundParams as R, type Secret as S, type UnmappedDepositResult as U, type WithdrawParams as W, type XConnection as X, type SecretHash as a, type DepositResult as b, type WithdrawResult as c, type RefundResult as d, type DropInbox as e, type HistoryType as f, type HistoryStatus as g, type HistoryPage as h, type RecipientChangeSignature as i, type RecipientSignature as j, type BatchClaimResult as k, type BatchClaimSignature as l, type SafeDropApiPort as m, type DropSender as n, type HistoryEntry as o, type HistoryParty as p, type HistoryReceiverParty as q, type LeaderboardEntry as r, type MappedDepositResult as s, SafeDropError as t, type SafeDropErrorCode as u, type SocialIdentifier as v, type SocialProvider as w };