@rhea-finance/confidential-swap 0.2.1 → 0.2.2

package/README.md

@@ -69,7 +69,7 @@ const result = await client.execute(plan, {
 
 The example assumes the application's existing wallet, asset, funding adapter and progress objects. The SDK does not connect wallets or manage UI. Connect and choose those objects in the application; do not pass private keys into the SDK. Quote plans have a default maximum age of 10 minutes, bounded by any earlier service-provided deadline; configure `maxQuoteAgeMs` when a different review window is required.
 
-`Token.assetId` identifies the registry asset. `blockchain` names its chain. `contractAddress` identifies its actual on-chain token. For numeric EVM funding identities supply the matching token `swapChain` (e.g. `"1"`); `swapAddress` explicitly maps an asset to the aggregation SDK's token address/native sentinel. No arbitrary EVM chain is guessed from `evm` kind alone.
+`Token.assetId` identifies the registry asset. `blockchain` names its chain. `contractAddress` identifies its actual on-chain token. For numeric EVM funding identities supply the matching token `swapChain` (e.g. `"1"`); `swapAddress` explicitly maps an asset to the funding swap token address/native sentinel used by the injected `FundingSwapAdapter`. No arbitrary EVM chain is guessed from `evm` kind alone.
 
 `preview` accepts an optional linking identity and returns `executable: false`. A placeholder identity is display-only. Preview/quote may allocate deposit addresses on the backend, but neither signs nor broadcasts funds. `quote` requires a real linking identity. Default withdrawal fees match the reference app: 2 bps to `dcl0001.near`, referral `rhea`. App fees are attached only to withdrawal quotes; funding deposit quotes do not include them. Configured `appFees` must contain at least one valid NEAR recipient and an integer fee from 1 to 10000.
 
@@ -77,7 +77,7 @@ The example assumes the application's existing wallet, asset, funding adapter an
 
 `FundingAdapter.getIdentity` returns `{ kind, accountId, chain }`. Its `validate` checks capability and the source chain without sending funds. Its `transfer` receives the real source token, smallest-unit amount, deposit address, optional memo and stable execution ID. Return a source transaction hash. Implement chain-specific transfer logic with the application's existing wallet SDK; an adapter must check identity again immediately before signing/broadcasting.
 
-For non-DIRECT funding, the funding adapter still validates the source wallet and chain, while `FundingSwapAdapter` performs quote/build/execute/report/status. Its quote data must be public and JSON-serializable. Its executor must use exactly the supplied source identity, chain and deposit recipient.
+For non-DIRECT funding, the funding adapter still validates the source wallet and chain, while `FundingSwapAdapter` performs quote/build/execute/report/status. Its quote data must be public and JSON-serializable. Its executor must use exactly the supplied source identity, chain and deposit recipient. The application owns the swap/bridge implementation; this package does not depend on a specific aggregation SDK.
 
 | Path | Waiting sequence |
 | --- | --- |
@@ -85,38 +85,12 @@ For non-DIRECT funding, the funding adapter still validates the source wallet an
 | SAME_CHAIN_SWAP | Swap to FLEX_INPUT, report, wait only for confidential deposit and balance |
 | CROSS_CHAIN_SWAP | Swap to FLEX_INPUT, report, wait for swap record success, then deposit and balance |
 
-All paths authorize the linking identity before sending source funds. Routing prefers registered direct assets, then same-chain USDC/USDT/USDT0, then a NEAR asset or another registry asset. Native NEAR maps to wNEAR. FLEX minimum input is checked against the final aggregation minimum output, with bounded requotes.
+All paths authorize the linking identity before sending source funds. Routing prefers registered direct assets, then same-chain USDC/USDT/USDT0, then a NEAR asset or another registry asset. Native NEAR maps to wNEAR. FLEX minimum input is checked against the final funding-swap minimum output, with bounded requotes.
 
 `fundingSource: 'balance'` spends only the requested amount from an existing registered confidential balance, without a source transaction. These balance withdrawals are checkpointed in process memory only and are never written to the configured `executionStore`, so they are not recoverable after reload. `mode: 'TRANSFER'` requires the same funding and destination asset; otherwise mode defaults to `SWAP`. A batch has 1-10 unique recipients on one destination chain and asset. Randomized positive shares preserve the exact raw total with roughly 80-120 percent equal-share bounds, allowing integer rounding. The frozen random fractions are stored in the plan and reused after re-quoting or recovery against the actual credited amount.
 
 Supply `addressValidator` for BTC/Zcash or unsupported destination chains, using an established chain library. Known EVM, NEAR, Solana, Tron, Aptos and Sui address formats are checked by default. Case-sensitive addresses are never lowercased or silently truncated.
 
-## Aggregation bridge
-
-The optional `@rhea-finance/confidential-swap/aggregation` entry exposes `createAggregationFundingAdapter` and `HttpFundingReporter`. Install the optional peer `@rhea-finance/cross-chain-aggregation-dex@^2.0.6` when using its bridge/types.
-
-```ts
-import { SwapClient } from '@rhea-finance/cross-chain-aggregation-dex';
-import {
-  createAggregationFundingAdapter,
-  HttpFundingReporter,
-} from '@rhea-finance/confidential-swap/aggregation';
-
-const swapClient = new SwapClient({
-  baseUrl: indexerUrl,
-  apiKey: configuredApiToken,
-  reportMode: 'manual', // no duplicate automatic reports
-  executors: sourceChainExecutors,
-});
-const fundingSwapAdapter = createAggregationFundingAdapter({
-  client: swapClient,
-  reporter: new HttpFundingReporter({ baseUrl: indexerUrl, bearerToken: configuredApiToken }),
-  mapAsset: token => ({ chain: mapSwapChain(token), address: mapSwapAddress(token) }),
-});
-```
-
-Unlike the aggregation SDK's ordinary order query, advanced funding status uses `/api/swap/order-status?recordId=...`. The reporter sends `confidentiality: 'advanced'`. API credentials must be provided by the application, not copied from the reference repository.
-
 ## Intent protocol boundary
 
 Withdrawal payloads are signed as returned by `/generate-intent`, matching the reference implementation. The SDK does not enforce a local transfer format or compare intent tokens and amounts against the quote. Signers, standards, nonces, deadlines and signatures are independently validated. NEP-413 withdrawal recipients are signed exactly as returned; authorization still requires the configured verifier. NEP-413 nonces accept Base64 or Base64URL and must decode to 32 bytes.
@@ -143,7 +117,7 @@ This is confidential-account orchestration, not a guarantee of end-to-end anonym
 
 ## Verification status
 
-Local tests exercise actual cryptographic signatures, the three-path/four-linking-kind matrix, source wallet separation, randomized integer bounds, HTTP fixtures, session recovery, ambiguous writes, partial statuses, price re-review and the published aggregation SDK client with mocked transport/execution. Packed ESM/CJS and consumer declarations are checked without React, wallet SDKs or the aggregation peer installed.
+Local tests exercise actual cryptographic signatures, the three-path/four-linking-kind matrix, source wallet separation, randomized integer bounds, HTTP fixtures, session recovery, ambiguous writes, partial statuses and price re-review. Packed ESM/CJS and consumer declarations are checked without React or wallet SDKs installed.
 
 Signature domain implementations follow the primary [NEAR NEP-413 specification](https://github.com/near/NEPs/blob/master/neps/nep-0413.md) and [TronWeb message implementation](https://github.com/tronprotocol/tronweb/blob/master/src/utils/message.ts).
 

package/dist/adapters/index.d.cts

@@ -1,5 +1,4 @@
-import { H as HttpConfidentialApi } from '../api-DfwMJoId.cjs';
-import { S as SigningAdapter } from '../types-DiDsRTKv.cjs';
+import { S as SigningAdapter, H as HttpConfidentialApi } from '../api-QSK8yzxM.cjs';
 
 interface EvmMessageSigner {
     getAddress(): Promise<string>;

package/dist/adapters/index.d.ts

@@ -1,5 +1,4 @@
-import { H as HttpConfidentialApi } from '../api-Cs0IyUJf.js';
-import { S as SigningAdapter } from '../types-DiDsRTKv.js';
+import { S as SigningAdapter, H as HttpConfidentialApi } from '../api-QSK8yzxM.js';
 
 interface EvmMessageSigner {
     getAddress(): Promise<string>;

package/dist/{types-DiDsRTKv.d.cts → api-QSK8yzxM.d.cts}

@@ -292,4 +292,55 @@ interface ExecuteOptions {
     onSignatureProgress?: (progress: SignatureProgress) => void;
 }
 
-export type { AppFeeEstimate as A, Balance as B, ConfidentialApi as C, ExecutionSnapshot as E, FundingSwapAdapter as F, LinkingKind as L, OrderPage as O, PollingOptions as P, QuotePlan as Q, SigningAdapter as S, Token as T, UnsignedData as U, WalletKind as W, LinkingIdentity as a, FundingIdentity as b, SigningStandard as c, FundingRoute as d, FundingAdapter as e, SessionStore as f, ExecutionStore as g, QuoteResponse as h, QuoteRequest as i, Login as j, ExecuteOptions as k, ExecutionStage as l, FundingReceipt as m, FundingRouteKind as n, FundingSwapQuote as o, PrivateOrder as p, PrivateWithdrawRequest as q, PrivateWithdrawRow as r, QuoteParams as s, Session as t, SignatureProgress as u, SignedData as v, StatusResponse as w, SwapFundingRequest as x, WithdrawPreview as y, WithdrawProgress as z };
+interface AppFee {
+    recipient: string;
+    fee: number;
+}
+interface HttpApiConfig {
+    /** Full /v0 URL; balances are sent here, never to the proxy. */
+    directUrl: string;
+    /** Full /proxy/1click/v0 URL. */
+    proxyUrl: string;
+    /** Indexer root URL. */
+    indexerUrl: string;
+    nearRpcUrl: string;
+    intentsContract?: string;
+    fetch?: typeof fetch;
+    now?: () => number;
+    randomBytes?: (length: number) => Uint8Array;
+    /** Reference implementation submits signed payloads without Bearer. */
+    withdrawAuthorization?: "signed-payload" | "bearer";
+    referral?: string;
+    appFees?: AppFee[];
+    requestTimeoutMs?: number;
+}
+declare class HttpConfidentialApi implements ConfidentialApi {
+    private readonly config;
+    readonly environment: string;
+    readonly intentsContract: string;
+    private readonly fetcher;
+    private readonly now;
+    private readonly direct;
+    private readonly proxy;
+    private readonly indexer;
+    private readonly appFees;
+    constructor(config: HttpApiConfig);
+    private request;
+    viewIntents<T>(method: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<T>;
+    createAuthPayload(signerId: string, standard: SigningStandard, signal?: AbortSignal): Promise<UnsignedData>;
+    private session;
+    authenticate(data: SignedData, signal?: AbortSignal): Promise<Session>;
+    refresh(session: Session, signal?: AbortSignal): Promise<Session>;
+    getTokens(signal?: AbortSignal): Promise<Token[]>;
+    getBalances(token: string, signal?: AbortSignal): Promise<Balance[]>;
+    estimateWithdrawalAppFee(amount: string, assetId: string): AppFeeEstimate;
+    quote(params: QuoteParams, signal?: AbortSignal): Promise<QuoteResponse>;
+    generateIntent(signerId: string, address: string, standard: SigningStandard, signal?: AbortSignal): Promise<UnsignedData>;
+    submitIntent(signedData: SignedData, signal?: AbortSignal): Promise<string>;
+    private privateRequest;
+    submitWithdraws(request: PrivateWithdrawRequest, token: string, signal?: AbortSignal): Promise<string>;
+    getStatus(address: string, memo?: string, signal?: AbortSignal): Promise<StatusResponse>;
+    getOrders(token: string, signerId: string, limit: number, offset: number, signal?: AbortSignal): Promise<OrderPage>;
+}
+
+export { type AppFee as A, type Balance as B, type ConfidentialApi as C, type WithdrawPreview as D, type ExecutionStore as E, type FundingIdentity as F, type WithdrawProgress as G, HttpConfidentialApi as H, type LinkingKind as L, type OrderPage as O, type PollingOptions as P, type QuotePlan as Q, type SigningAdapter as S, type Token as T, type UnsignedData as U, type WalletKind as W, type LinkingIdentity as a, type SigningStandard as b, type FundingRoute as c, type FundingAdapter as d, type FundingSwapAdapter as e, type SessionStore as f, type QuoteResponse as g, type QuoteRequest as h, type Login as i, type ExecutionSnapshot as j, type ExecuteOptions as k, type AppFeeEstimate as l, type ExecutionStage as m, type FundingReceipt as n, type FundingRouteKind as o, type FundingSwapQuote as p, type HttpApiConfig as q, type PrivateOrder as r, type PrivateWithdrawRequest as s, type PrivateWithdrawRow as t, type QuoteParams as u, type Session as v, type SignatureProgress as w, type SignedData as x, type StatusResponse as y, type SwapFundingRequest as z };

package/dist/{types-DiDsRTKv.d.ts → api-QSK8yzxM.d.ts}

@@ -292,4 +292,55 @@ interface ExecuteOptions {
     onSignatureProgress?: (progress: SignatureProgress) => void;
 }
 
-export type { AppFeeEstimate as A, Balance as B, ConfidentialApi as C, ExecutionSnapshot as E, FundingSwapAdapter as F, LinkingKind as L, OrderPage as O, PollingOptions as P, QuotePlan as Q, SigningAdapter as S, Token as T, UnsignedData as U, WalletKind as W, LinkingIdentity as a, FundingIdentity as b, SigningStandard as c, FundingRoute as d, FundingAdapter as e, SessionStore as f, ExecutionStore as g, QuoteResponse as h, QuoteRequest as i, Login as j, ExecuteOptions as k, ExecutionStage as l, FundingReceipt as m, FundingRouteKind as n, FundingSwapQuote as o, PrivateOrder as p, PrivateWithdrawRequest as q, PrivateWithdrawRow as r, QuoteParams as s, Session as t, SignatureProgress as u, SignedData as v, StatusResponse as w, SwapFundingRequest as x, WithdrawPreview as y, WithdrawProgress as z };
+interface AppFee {
+    recipient: string;
+    fee: number;
+}
+interface HttpApiConfig {
+    /** Full /v0 URL; balances are sent here, never to the proxy. */
+    directUrl: string;
+    /** Full /proxy/1click/v0 URL. */
+    proxyUrl: string;
+    /** Indexer root URL. */
+    indexerUrl: string;
+    nearRpcUrl: string;
+    intentsContract?: string;
+    fetch?: typeof fetch;
+    now?: () => number;
+    randomBytes?: (length: number) => Uint8Array;
+    /** Reference implementation submits signed payloads without Bearer. */
+    withdrawAuthorization?: "signed-payload" | "bearer";
+    referral?: string;
+    appFees?: AppFee[];
+    requestTimeoutMs?: number;
+}
+declare class HttpConfidentialApi implements ConfidentialApi {
+    private readonly config;
+    readonly environment: string;
+    readonly intentsContract: string;
+    private readonly fetcher;
+    private readonly now;
+    private readonly direct;
+    private readonly proxy;
+    private readonly indexer;
+    private readonly appFees;
+    constructor(config: HttpApiConfig);
+    private request;
+    viewIntents<T>(method: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<T>;
+    createAuthPayload(signerId: string, standard: SigningStandard, signal?: AbortSignal): Promise<UnsignedData>;
+    private session;
+    authenticate(data: SignedData, signal?: AbortSignal): Promise<Session>;
+    refresh(session: Session, signal?: AbortSignal): Promise<Session>;
+    getTokens(signal?: AbortSignal): Promise<Token[]>;
+    getBalances(token: string, signal?: AbortSignal): Promise<Balance[]>;
+    estimateWithdrawalAppFee(amount: string, assetId: string): AppFeeEstimate;
+    quote(params: QuoteParams, signal?: AbortSignal): Promise<QuoteResponse>;
+    generateIntent(signerId: string, address: string, standard: SigningStandard, signal?: AbortSignal): Promise<UnsignedData>;
+    submitIntent(signedData: SignedData, signal?: AbortSignal): Promise<string>;
+    private privateRequest;
+    submitWithdraws(request: PrivateWithdrawRequest, token: string, signal?: AbortSignal): Promise<string>;
+    getStatus(address: string, memo?: string, signal?: AbortSignal): Promise<StatusResponse>;
+    getOrders(token: string, signerId: string, limit: number, offset: number, signal?: AbortSignal): Promise<OrderPage>;
+}
+
+export { type AppFee as A, type Balance as B, type ConfidentialApi as C, type WithdrawPreview as D, type ExecutionStore as E, type FundingIdentity as F, type WithdrawProgress as G, HttpConfidentialApi as H, type LinkingKind as L, type OrderPage as O, type PollingOptions as P, type QuotePlan as Q, type SigningAdapter as S, type Token as T, type UnsignedData as U, type WalletKind as W, type LinkingIdentity as a, type SigningStandard as b, type FundingRoute as c, type FundingAdapter as d, type FundingSwapAdapter as e, type SessionStore as f, type QuoteResponse as g, type QuoteRequest as h, type Login as i, type ExecutionSnapshot as j, type ExecuteOptions as k, type AppFeeEstimate as l, type ExecutionStage as m, type FundingReceipt as n, type FundingRouteKind as o, type FundingSwapQuote as p, type HttpApiConfig as q, type PrivateOrder as r, type PrivateWithdrawRequest as s, type PrivateWithdrawRow as t, type QuoteParams as u, type Session as v, type SignatureProgress as w, type SignedData as x, type StatusResponse as y, type SwapFundingRequest as z };

package/dist/index.cjs

@@ -310,6 +310,10 @@ function buildFundingRouteCandidates(source, destination, preferred, registry, o
     for (const mid of midCandidates()) add(routeKindFor(mid), mid);
     return routes;
   }
+  if (sourceChain === "sui" || sourceChain === "tron") {
+    add(routeKindFor(destination), destination);
+    return routes;
+  }
   for (const mid of midCandidates()) add(routeKindFor(mid), mid);
   if (routes.length === 0) return [preferred];
   return routes;