@sodax/types 2.0.0-rc.2 → 2.0.0-rc.20

package/dist/backend/backendApiV2.js

@@ -0,0 +1,38 @@
+// Backend Swaps API v2 — request/response contract types.
+//
+// One type per request/response of every endpoint in the backend `swaps-api`
+// controller (`apps/swaps-api/src/api/swaps/swaps.controller.ts`). They favor
+// plain primitives (`string`/`number`/`boolean`/`bigint`/plain objects) over SDK
+// branded types.
+//
+// Inbound (request) and outbound (response) shapes are SEPARATE types because the
+// two directions genuinely differ:
+// - Outbound (response) types are pure JSON: every bigint-derived value (intent
+//   ids, amounts, deadlines, fees, relay chain ids) is a decimal `string`, and
+//   every `Date` is an ISO 8601 `string` (e.g. `abandonedAt`). A response NEVER
+//   contains `bigint` on the wire — JSON cannot represent it (the one typed
+//   exception is the unsigned `tx`; see below).
+// - Inbound (request) types mirror the server's parsed request DTOs: the Intent
+//   struct (`IntentRequestV2`) carries `bigint` for its numeric fields, matching
+//   the backend `IntentDto`. Other request fields (amounts/deadlines on
+//   `CreateIntentParamsV2`/`QuoteRequestV2`, fees, relay chain ids, etc.) are
+//   decimal `string`, matching their `@IsNumberString` DTO fields.
+// - `Hex` / `Address` / `Hash` / `SpokeChainKey` are plain `string` everywhere.
+// - The unsigned `tx` is typed as the SDK domain union `RawTxReturnType`. It
+//   travels as pure JSON (bigints stringified; Injective byte arrays as
+//   `{ "0": N, … }` index objects), and the SDK client's response schema
+//   (`@sodax/sdk` `rawTxSchemas`) rebuilds the domain shape (`bigint`,
+//   `Uint8Array`) on parse — the inverse of the backend's `stringifyBigInts`.
+// - The remaining chain-specific opaque payloads (gas estimate, raw relay
+//   `result`) stay `unknown` because their shape varies by chain family.
+//
+// Shapes used in both directions are split into a `*RequestV2` (client → server)
+// and a `*ResponseV2` (server → client) interface. `IntentRequestV2` (bigint
+// numerics) and `IntentResponseV2` (all-string) genuinely differ;
+// `RelayExtraDataRequestV2` / `RelayExtraDataResponseV2` are identical (no bigint
+// fields). This mirrors the backend's request/response DTO pairs.
+//
+// The Config API v2 section at the bottom of this file takes a DIFFERENT approach
+// (see its header): it REUSES the canonical `@sodax/types` config types and projects
+// only the few bigint fields to `string`, rather than re-declaring a parallel tree.
+export {};

package/dist/backend/index.d.ts

@@ -1,2 +1,2 @@
-export * from './backendApi.js';
-//# sourceMappingURL=index.d.ts.map
+export * from './backendApiV1.js';
+export * from './backendApiV2.js';

package/dist/backend/index.js

@@ -1,2 +1,2 @@
-export * from './backendApi.js';
-//# sourceMappingURL=index.js.map
+export * from './backendApiV1.js';
+export * from './backendApiV2.js';

package/dist/bitcoin/bitcoin.d.ts

@@ -6,6 +6,17 @@ export declare function isSupportedBitcoinAddressType(addressType: string): addr
  * Shared utility — use this instead of duplicating prefix checks.
  */
 export declare function detectBitcoinAddressType(address: string): BtcAddressType;
+/**
+ * Off-chain message-signing scheme a Bitcoin address type must use: BIP-322 vs ECDSA (BIP-137).
+ *
+ * - **P2WPKH / P2TR → BIP-322.** Taproot keys are Schnorr/x-only, so ECDSA cannot sign for them
+ *   (and wallets like Xverse default to Taproot).
+ * - **P2SH / P2PKH → ECDSA (BIP-137).** Browser wallets (UniSat/OKX) reject BIP-322 on
+ *   nested-segwit/legacy addresses — they throw "Not support address type to sign".
+ *
+ * No single scheme works for every address type, so signers AND verifiers must branch on this.
+ */
+export declare function usesBip322MessageSigning(addressType: BtcAddressType): boolean;
 export declare const BTC_WALLET_ADDRESS_TYPES: readonly ["taproot", "segwit"];
 /** User-friendly Bitcoin address type for wallet connection. */
 export type BtcWalletAddressType = (typeof BTC_WALLET_ADDRESS_TYPES)[number];
@@ -86,6 +97,13 @@ export interface IBitcoinWalletProvider extends ICoreWallet {
     signTransaction(psbt: string, finalize?: boolean): Promise<string>;
     signEcdsaMessage(message: string): Promise<string>;
     signBip322Message(message: string): Promise<string>;
+    /**
+     * Get the signer's public key as a hex string. Optional capability: required only for the
+     * money-market on-demand (borrow/withdraw) flow, where the relay needs the key to verify a
+     * BIP-322 (Schnorr/Taproot) signature — which is not public-key-recoverable. Wallets that
+     * cannot expose it omit this method; callers guard before use.
+     */
+    getPublicKey?(): Promise<string>;
     /**
      * Send Bitcoin to an address
      * @param toAddress - Destination Bitcoin address
@@ -106,4 +124,3 @@ export interface UTXO {
     };
 }
 export {};
-//# sourceMappingURL=bitcoin.d.ts.map

package/dist/bitcoin/bitcoin.js

@@ -17,7 +17,19 @@ export function detectBitcoinAddressType(address) {
         return 'P2PKH';
     throw new Error(`Unknown Bitcoin address type: ${address}`);
 }
+/**
+ * Off-chain message-signing scheme a Bitcoin address type must use: BIP-322 vs ECDSA (BIP-137).
+ *
+ * - **P2WPKH / P2TR → BIP-322.** Taproot keys are Schnorr/x-only, so ECDSA cannot sign for them
+ *   (and wallets like Xverse default to Taproot).
+ * - **P2SH / P2PKH → ECDSA (BIP-137).** Browser wallets (UniSat/OKX) reject BIP-322 on
+ *   nested-segwit/legacy addresses — they throw "Not support address type to sign".
+ *
+ * No single scheme works for every address type, so signers AND verifiers must branch on this.
+ */
+export function usesBip322MessageSigning(addressType) {
+    return addressType === 'P2WPKH' || addressType === 'P2TR';
+}
 export const BTC_WALLET_ADDRESS_TYPES = ['taproot', 'segwit'];
 /** Address types that Sodax supports for transactions. */
 const BTC_ADDRESS_TYPES = ['P2PKH', 'P2SH', 'P2WPKH', 'P2TR'];
-//# sourceMappingURL=bitcoin.js.map

package/dist/bitcoin/index.d.ts

@@ -1,2 +1 @@
 export * from './bitcoin.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/bitcoin/index.js

@@ -1,2 +1 @@
 export * from './bitcoin.js';
-//# sourceMappingURL=index.js.map

package/dist/chains/chain-keys.d.ts

@@ -23,9 +23,9 @@ export declare const ChainKeys: {
     readonly REDBELLY_MAINNET: "redbelly";
     readonly KAIA_MAINNET: "0x2019.kaia";
     readonly STACKS_MAINNET: "stacks";
+    readonly HEDERA_MAINNET: "hedera";
 };
 export type ChainKey = (typeof ChainKeys)[keyof typeof ChainKeys];
-export declare const CHAIN_KEYS: ("0xa86a.avax" | "0xa4b1.arbitrum" | "0x2105.base" | "0x38.bsc" | "injective-1" | "sonic" | "0x1.icon" | "sui" | "0xa.optimism" | "0x89.polygon" | "solana" | "stellar" | "hyper" | "lightlink" | "near" | "ethereum" | "bitcoin" | "redbelly" | "0x2019.kaia" | "stacks")[];
-export declare const spokeChainKeysSet: Set<"0xa86a.avax" | "0xa4b1.arbitrum" | "0x2105.base" | "0x38.bsc" | "injective-1" | "sonic" | "0x1.icon" | "sui" | "0xa.optimism" | "0x89.polygon" | "solana" | "stellar" | "hyper" | "lightlink" | "near" | "ethereum" | "bitcoin" | "redbelly" | "0x2019.kaia" | "stacks">;
+export declare const CHAIN_KEYS: ("0xa86a.avax" | "0xa4b1.arbitrum" | "0x2105.base" | "0x38.bsc" | "injective-1" | "sonic" | "0x1.icon" | "sui" | "0xa.optimism" | "0x89.polygon" | "solana" | "stellar" | "hyper" | "lightlink" | "near" | "ethereum" | "bitcoin" | "redbelly" | "0x2019.kaia" | "stacks" | "hedera")[];
+export declare const spokeChainKeysSet: Set<"0xa86a.avax" | "0xa4b1.arbitrum" | "0x2105.base" | "0x38.bsc" | "injective-1" | "sonic" | "0x1.icon" | "sui" | "0xa.optimism" | "0x89.polygon" | "solana" | "stellar" | "hyper" | "lightlink" | "near" | "ethereum" | "bitcoin" | "redbelly" | "0x2019.kaia" | "stacks" | "hedera">;
 export type ChainType = (typeof ChainTypeArr)[number];
-//# sourceMappingURL=chain-keys.d.ts.map

package/dist/chains/chain-keys.js

@@ -33,7 +33,7 @@ export const ChainKeys = {
     REDBELLY_MAINNET: 'redbelly',
     KAIA_MAINNET: '0x2019.kaia',
     STACKS_MAINNET: 'stacks',
+    HEDERA_MAINNET: 'hedera',
 };
 export const CHAIN_KEYS = Object.values(ChainKeys);
 export const spokeChainKeysSet = new Set(CHAIN_KEYS);
-//# sourceMappingURL=chain-keys.js.map