@bloque/sdk-swap 0.0.32 → 0.0.34

package/dist/bank-transfer/bank-transfer-client.d.ts

@@ -0,0 +1,53 @@
+import { BaseClient } from '@bloque/sdk-core';
+import type { CreateBankTransferOrderParams, CreateBankTransferOrderResult } from './types';
+/**
+ * Generic bank transfer client for cash-out swaps
+ *
+ * Supports any Colombian bank as the destination medium.
+ * The specific bank is selected via the `toMedium` parameter when creating an order.
+ *
+ * @example
+ * ```typescript
+ * const result = await bloque.swap.bankTransfer.create({
+ *   rateSig: rate.sig,
+ *   toMedium: 'banco_de_bogota',
+ *   amountSrc: '5000000',
+ *   depositInformation: {
+ *     bankAccountType: 'savings',
+ *     bankAccountNumber: '123456789',
+ *     bankAccountHolderName: 'Juan Pérez',
+ *     bankAccountHolderIdentificationType: 'CC',
+ *     bankAccountHolderIdentificationValue: '1234567890',
+ *   },
+ *   args: { accountUrn: 'did:bloque:card:abc123' },
+ * });
+ * ```
+ */
+export declare class BankTransferClient extends BaseClient {
+    /**
+     * Create a bank transfer swap order
+     *
+     * Creates a swap order using Kusama as the source and any supported
+     * Colombian bank as the destination. The target bank is specified
+     * via `params.toMedium`.
+     *
+     * @param params - Bank transfer order parameters
+     * @returns Promise resolving to the created order with optional execution result
+     */
+    create(params: CreateBankTransferOrderParams): Promise<CreateBankTransferOrderResult>;
+    /**
+     * Maps SDK deposit information to wire format
+     * @internal
+     */
+    private _mapDepositInformationToWire;
+    /**
+     * Maps API order response to SDK format
+     * @internal
+     */
+    private _mapOrderResponse;
+    /**
+     * Maps API execution result to SDK format
+     * @internal
+     */
+    private _mapExecutionResult;
+}

package/dist/bank-transfer/types.d.ts

@@ -0,0 +1,242 @@
+/**
+ * Generic bank transfer types for @bloque/sdk-swap
+ *
+ * Supports any Colombian bank as the destination medium for cash-out swaps.
+ */
+/**
+ * Supported Colombian banks for cash-out transfers
+ *
+ * @example Transfer to Bancolombia
+ * ```typescript
+ * await bloque.swap.bankTransfer.create({
+ *   rateSig: rate.sig,
+ *   toMedium: 'bancolombia',
+ *   amountSrc: '5000000',
+ *   depositInformation: {
+ *     bankAccountType: 'savings',
+ *     bankAccountNumber: '5740088718',
+ *     bankAccountHolderName: 'Juan Pérez',
+ *     bankAccountHolderIdentificationType: 'CC',
+ *     bankAccountHolderIdentificationValue: '1234567890',
+ *   },
+ *   args: { sourceAccountUrn: 'did:bloque:card:abc123' },
+ * });
+ * ```
+ *
+ * @example Transfer to Banco de Bogotá
+ * ```typescript
+ * await bloque.swap.bankTransfer.create({
+ *   rateSig: rate.sig,
+ *   toMedium: 'banco_de_bogota',
+ *   amountSrc: '2000000',
+ *   depositInformation: {
+ *     bankAccountType: 'checking',
+ *     bankAccountNumber: '987654321',
+ *     bankAccountHolderName: 'María López',
+ *     bankAccountHolderIdentificationType: 'CE',
+ *     bankAccountHolderIdentificationValue: '456789',
+ *   },
+ *   args: { sourceAccountUrn: 'did:bloque:card:xyz789' },
+ * });
+ * ```
+ *
+ * @example Transfer to BBVA Colombia
+ * ```typescript
+ * await bloque.swap.bankTransfer.create({
+ *   rateSig: rate.sig,
+ *   toMedium: 'banco_bbva_colombia',
+ *   amountSrc: '10000000',
+ *   depositInformation: {
+ *     bankAccountType: 'savings',
+ *     bankAccountNumber: '1122334455',
+ *     bankAccountHolderName: 'Carlos Ruiz',
+ *     bankAccountHolderIdentificationType: 'NIT',
+ *     bankAccountHolderIdentificationValue: '900123456',
+ *   },
+ *   args: { sourceAccountUrn: 'did:bloque:card:def456' },
+ * });
+ * ```
+ */
+export type SupportedBank = 'banco_agrario_de_colombia' | 'banco_av_villas' | 'banco_bancamia' | 'banco_bbva_colombia' | 'banco_btg_pactual_colombia' | 'citibank_colombia' | 'banco_caja_social_bcsc' | 'davibank' | 'banco_contactar' | 'banco_cooperativo_coopcentral' | 'ban100' | 'banco_davivienda' | 'banco_de_bogota' | 'banco_de_occidente' | 'banco_gnb_sudameris' | 'banco_jp_morgan_colombia' | 'banco_popular' | 'banco_itau' | 'bancolombia' | 'banco_w' | 'banco_coomeva' | 'banco_finandina_bic' | 'banco_falabella' | 'banco_pichincha' | 'banco_santander_de_negocios_colombia' | 'banco_mundo_mujer' | 'banco_serfinanza' | 'mibanco' | 'lulo_bank' | 'banco_union';
+/**
+ * Bank account type
+ */
+export type BankAccountType = 'savings' | 'checking';
+/**
+ * Identification type for account holder
+ */
+export type IdentificationType = 'CC' | 'CE' | 'NIT' | 'PP';
+/**
+ * Bank deposit information for direct bank transfers
+ *
+ * This is the same shape for all Colombian banks — the specific bank
+ * is selected via the `toMedium` parameter in the order.
+ */
+export interface BankDepositInformation {
+    /**
+     * Bank account type
+     * @example "savings"
+     */
+    bankAccountType: BankAccountType;
+    /**
+     * Bank account number
+     * @example "5740088718"
+     */
+    bankAccountNumber: string;
+    /**
+     * Account holder full name
+     * @example "david barinas"
+     */
+    bankAccountHolderName: string;
+    /**
+     * Account holder identification type
+     * @example "CC"
+     */
+    bankAccountHolderIdentificationType: IdentificationType;
+    /**
+     * Account holder identification number
+     * @example "123456789"
+     */
+    bankAccountHolderIdentificationValue: string;
+}
+/**
+ * Kusama account arguments for swap execution
+ */
+export interface KusamaAccountArgs {
+    /**
+     * Account URN where funds will be debited from
+     * @example "did:bloque:card:1231231"
+     */
+    sourceAccountUrn: string;
+}
+/**
+ * Order type for swap
+ * - 'src': Taker specifies exact source amount to pay
+ * - 'dst': Taker specifies exact destination amount to receive
+ */
+export type OrderType = 'src' | 'dst';
+/**
+ * Parameters for creating a bank transfer swap order
+ */
+export interface CreateBankTransferOrderParams {
+    /**
+     * Rate signature from findRates
+     */
+    rateSig: string;
+    /**
+     * Destination bank medium (e.g., "bancolombia", "banco_de_bogota", "banco_davivienda")
+     * @example "banco_bbva_colombia"
+     */
+    toMedium: SupportedBank;
+    /**
+     * Source amount as bigint string (required if type is 'src')
+     * @example "100000000"
+     */
+    amountSrc?: string;
+    /**
+     * Destination amount as bigint string (required if type is 'dst')
+     * @example "50000000" represents 500000.00 COP
+     */
+    amountDst?: string;
+    /**
+     * Order type (default: 'src')
+     */
+    type?: OrderType;
+    /**
+     * Bank account information for fund delivery
+     */
+    depositInformation: BankDepositInformation;
+    /**
+     * Kusama account arguments for swap execution
+     */
+    args: KusamaAccountArgs;
+    /**
+     * Specific node ID to execute (defaults to first node)
+     */
+    nodeId?: string;
+    /**
+     * Additional metadata for the order
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Swap order details
+ */
+export interface SwapOrder {
+    /** Unique order identifier */
+    id: string;
+    /** Order signature */
+    orderSig: string;
+    /** Rate signature used for this order */
+    rateSig: string;
+    /** Swap signature */
+    swapSig: string;
+    /** Taker URN */
+    taker: string;
+    /** Maker URN */
+    maker: string;
+    /** Source asset */
+    fromAsset: string;
+    /** Destination asset */
+    toAsset: string;
+    /** Source medium */
+    fromMedium: string;
+    /** Destination medium (bank name) */
+    toMedium: string;
+    /** Source amount */
+    fromAmount: string;
+    /** Destination amount */
+    toAmount: string;
+    /** Timestamp when the order was created */
+    at: string;
+    /** Instruction graph ID for tracking execution */
+    graphId: string;
+    /** Order status */
+    status: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Last update timestamp */
+    updatedAt: string;
+}
+/**
+ * Redirect instructions for completing the payment
+ */
+export interface ExecutionHow {
+    /** Type of action required (e.g., "REDIRECT") */
+    type: string;
+    /** URL to redirect the user to complete the payment */
+    url: string;
+}
+/**
+ * Execution result from auto-execution
+ */
+export interface ExecutionResult {
+    /** Node ID that was executed */
+    nodeId: string;
+    /** Execution result details */
+    result: {
+        /** Execution status (e.g., "paused") */
+        status: string;
+        /** Name of the current step */
+        name?: string;
+        /** Description of what the user needs to do */
+        description?: string;
+        /** Instructions for completing this step */
+        how?: ExecutionHow;
+        /** Callback token for tracking */
+        callbackToken?: string;
+    };
+}
+/**
+ * Result of creating a bank transfer swap order
+ */
+export interface CreateBankTransferOrderResult {
+    /** The created order */
+    order: SwapOrder;
+    /** Execution result (if args were provided for auto-execution) */
+    execution?: ExecutionResult;
+    /** Request ID for tracking */
+    requestId: string;
+}

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";const __rslib_import_meta_url__="u"<typeof document?new(require("url".replace("",""))).URL("file:"+__filename).href:document.currentScript&&document.currentScript.src||new URL("main.js",document.baseURI).href;var __webpack_require__={};__webpack_require__.d=(e,t)=>{for(var a in t)__webpack_require__.o(t,a)&&!__webpack_require__.o(e,a)&&Object.defineProperty(e,a,{enumerable:!0,get:t[a]})},__webpack_require__.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),__webpack_require__.r=e=>{"u">typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var __webpack_exports__={};__webpack_require__.r(__webpack_exports__),__webpack_require__.d(__webpack_exports__,{SwapClient:()=>SwapClient,PseClient:()=>PseClient});const sdk_core_namespaceObject=require("@bloque/sdk-core");class PseClient extends sdk_core_namespaceObject.BaseClient{async banks(){return{banks:(await this.httpClient.request({method:"GET",path:"/api/utils/pse/banks"})).banks.map(e=>this._mapBankResponse(e))}}async create(e){let t=this.httpClient.urn;if(!t)throw new sdk_core_namespaceObject.BloqueConfigError("User URN is not available. Please connect to a session first.");let a=e.type??"src",r={taker_urn:t,type:a,rate_sig:e.rateSig,from_medium:"pse",to_medium:e.toMedium,deposit_information:this._mapDepositInformationToWire(e.depositInformation)};"src"===a&&e.amountSrc?r.amount_src=e.amountSrc:"dst"===a&&e.amountDst&&(r.amount_dst=e.amountDst),e.args&&(r.args={bank_code:e.args.bankCode,...e.args.userType&&{user_type:e.args.userType},...e.args.customerEmail&&{customer_email:e.args.customerEmail},...e.args.userLegalIdType&&{user_legal_id_type:e.args.userLegalIdType},...e.args.userLegalId&&{user_legal_id:e.args.userLegalId},...e.args.customerData&&{customer_data:{full_name:e.args.customerData.fullName}}}),e.nodeId&&(r.node_id=e.nodeId),e.metadata&&(r.metadata=e.metadata);let s=await this.httpClient.request({method:"PUT",path:"/api/order",body:r});return{order:this._mapOrderResponse(s.result.order),execution:s.result.execution?this._mapExecutionResult(s.result.execution):void 0,requestId:s.req_id}}_mapBankResponse(e){return{code:e.financial_institution_code,name:e.financial_institution_name}}_mapDepositInformationToWire(e){return{urn:e.urn}}_mapOrderResponse(e){return{id:e.id,orderSig:e.order_sig,rateSig:e.rate_sig,swapSig:e.swap_sig,taker:e.taker,maker:e.maker,fromAsset:e.from_asset,toAsset:e.to_asset,fromMedium:e.from_medium,toMedium:e.to_medium,fromAmount:e.from_amount,toAmount:e.to_amount,at:e.at,graphId:e.graph_id,status:e.status,metadata:e.metadata,createdAt:e.created_at,updatedAt:e.updated_at}}_mapExecutionResult(e){return{nodeId:e.node_id,result:{status:e.result.status,name:e.result.name,description:e.result.description,how:e.result.how,callbackToken:e.result.callback_token}}}}class SwapClient extends sdk_core_namespaceObject.BaseClient{pse;constructor(e){super(e),this.pse=new PseClient(this.httpClient)}async findRates(e){let t=new URLSearchParams,a=JSON.stringify([e.fromAsset,e.toAsset]);t.append("edge",a),t.append("from_medium",JSON.stringify(e.fromMediums)),t.append("to_medium",JSON.stringify(e.toMediums)),void 0!==e.amountSrc&&t.append("amount_src",e.amountSrc),void 0!==e.amountDst&&t.append("amount_dst",e.amountDst),e.sort&&t.append("sort",e.sort),e.sortBy&&t.append("sort_by",e.sortBy);let r=t.toString(),s=`/api/rates?${r}`;return{rates:(await this.httpClient.request({method:"GET",path:s})).rates.map(e=>this._mapRateResponse(e))}}_mapRateResponse(e){return{id:e.id,sig:e.sig,swapSig:e.swap_sig,maker:e.maker,edge:e.edge,fee:{at:e.fee.at,value:e.fee.value,formula:e.fee.formula,components:e.fee.components.map(e=>({at:e.at,name:e.name,type:e.type,value:e.value,percentage:e.percentage,pair:e.pair,amount:e.amount}))},at:e.at,until:e.until,fromMediums:e.from_medium,toMediums:e.to_medium,rate:e.rate,ratio:e.ratio,fromLimits:e.from_limits,toLimits:e.to_limits,createdAt:e.created_at,updatedAt:e.updated_at}}}for(var __rspack_i in exports.PseClient=__webpack_exports__.PseClient,exports.SwapClient=__webpack_exports__.SwapClient,__webpack_exports__)-1===["PseClient","SwapClient"].indexOf(__rspack_i)&&(exports[__rspack_i]=__webpack_exports__[__rspack_i]);Object.defineProperty(exports,"__esModule",{value:!0});
+"use strict";const __rslib_import_meta_url__="u"<typeof document?new(require("url".replace("",""))).URL("file:"+__filename).href:document.currentScript&&document.currentScript.src||new URL("main.js",document.baseURI).href;var __webpack_require__={};__webpack_require__.d=(e,t)=>{for(var a in t)__webpack_require__.o(t,a)&&!__webpack_require__.o(e,a)&&Object.defineProperty(e,a,{enumerable:!0,get:t[a]})},__webpack_require__.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),__webpack_require__.r=e=>{"u">typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})};var __webpack_exports__={};__webpack_require__.r(__webpack_exports__),__webpack_require__.d(__webpack_exports__,{SwapClient:()=>SwapClient,BankTransferClient:()=>BankTransferClient,PseClient:()=>PseClient});const sdk_core_namespaceObject=require("@bloque/sdk-core");class BankTransferClient extends sdk_core_namespaceObject.BaseClient{async create(e){let t=this.httpClient.urn;if(!t)throw new sdk_core_namespaceObject.BloqueConfigError("User URN is not available. Please connect to a session first.");let a=e.type??"src",r={taker_urn:t,type:a,rate_sig:e.rateSig,from_medium:"kusama",to_medium:e.toMedium,deposit_information:this._mapDepositInformationToWire(e.depositInformation)};"src"===a&&e.amountSrc?r.amount_src=e.amountSrc:"dst"===a&&e.amountDst&&(r.amount_dst=e.amountDst),e.args&&(r.args={account_urn:e.args.sourceAccountUrn}),e.nodeId&&(r.node_id=e.nodeId),e.metadata&&(r.metadata=e.metadata);let s=await this.httpClient.request({method:"PUT",path:"/api/order",body:r});return{order:this._mapOrderResponse(s.result.order),execution:s.result.execution?this._mapExecutionResult(s.result.execution):void 0,requestId:s.req_id}}_mapDepositInformationToWire(e){return{bank_account_type:e.bankAccountType,bank_account_number:e.bankAccountNumber,bank_account_holder_name:e.bankAccountHolderName,bank_account_holder_identification_type:e.bankAccountHolderIdentificationType,bank_account_holder_identification_value:e.bankAccountHolderIdentificationValue}}_mapOrderResponse(e){return{id:e.id,orderSig:e.order_sig,rateSig:e.rate_sig,swapSig:e.swap_sig,taker:e.taker,maker:e.maker,fromAsset:e.from_asset,toAsset:e.to_asset,fromMedium:e.from_medium,toMedium:e.to_medium,fromAmount:e.from_amount,toAmount:e.to_amount,at:e.at,graphId:e.graph_id,status:e.status,metadata:e.metadata,createdAt:e.created_at,updatedAt:e.updated_at}}_mapExecutionResult(e){return{nodeId:e.node_id,result:{status:e.result.status,name:e.result.name,description:e.result.description,how:e.result.how,callbackToken:e.result.callback_token}}}}class PseClient extends sdk_core_namespaceObject.BaseClient{async banks(){return{banks:(await this.httpClient.request({method:"GET",path:"/api/utils/pse/banks"})).banks.map(e=>this._mapBankResponse(e))}}async create(e){let t=this.httpClient.urn;if(!t)throw new sdk_core_namespaceObject.BloqueConfigError("User URN is not available. Please connect to a session first.");let a=e.type??"src",r={taker_urn:t,type:a,rate_sig:e.rateSig,from_medium:"pse",to_medium:e.toMedium,deposit_information:this._mapDepositInformationToWire(e.depositInformation)};"src"===a&&e.amountSrc?r.amount_src=e.amountSrc:"dst"===a&&e.amountDst&&(r.amount_dst=e.amountDst),e.args&&(r.args={bank_code:e.args.bankCode,...e.args.userType&&{user_type:e.args.userType},...e.args.customerEmail&&{customer_email:e.args.customerEmail},...e.args.userLegalIdType&&{user_legal_id_type:e.args.userLegalIdType},...e.args.userLegalId&&{user_legal_id:e.args.userLegalId},...e.args.customerData&&{customer_data:{full_name:e.args.customerData.fullName,phone_number:e.args.customerData.phoneNumber}}}),e.nodeId&&(r.node_id=e.nodeId),e.metadata&&(r.metadata=e.metadata);let s=await this.httpClient.request({method:"PUT",path:"/api/order",body:r});return{order:this._mapOrderResponse(s.result.order),execution:s.result.execution?this._mapExecutionResult(s.result.execution):void 0,requestId:s.req_id}}_mapBankResponse(e){return{code:e.financial_institution_code,name:e.financial_institution_name}}_mapDepositInformationToWire(e){return{urn:e.urn}}_mapOrderResponse(e){return{id:e.id,orderSig:e.order_sig,rateSig:e.rate_sig,swapSig:e.swap_sig,taker:e.taker,maker:e.maker,fromAsset:e.from_asset,toAsset:e.to_asset,fromMedium:e.from_medium,toMedium:e.to_medium,fromAmount:e.from_amount,toAmount:e.to_amount,at:e.at,graphId:e.graph_id,status:e.status,metadata:e.metadata,createdAt:e.created_at,updatedAt:e.updated_at}}_mapExecutionResult(e){return{nodeId:e.node_id,result:{status:e.result.status,name:e.result.name,description:e.result.description,how:e.result.how,callbackToken:e.result.callback_token}}}}class SwapClient extends sdk_core_namespaceObject.BaseClient{pse;bankTransfer;constructor(e){super(e),this.pse=new PseClient(this.httpClient),this.bankTransfer=new BankTransferClient(this.httpClient)}async findRates(e){let t=new URLSearchParams,a=JSON.stringify([e.fromAsset,e.toAsset]);t.append("edge",a),t.append("from_medium",JSON.stringify(e.fromMediums)),t.append("to_medium",JSON.stringify(e.toMediums)),void 0!==e.amountSrc&&t.append("amount_src",e.amountSrc),void 0!==e.amountDst&&t.append("amount_dst",e.amountDst),e.sort&&t.append("sort",e.sort),e.sortBy&&t.append("sort_by",e.sortBy);let r=t.toString(),s=`/api/rates?${r}`;return{rates:(await this.httpClient.request({method:"GET",path:s})).rates.map(e=>this._mapRateResponse(e))}}_mapRateResponse(e){return{id:e.id,sig:e.sig,swapSig:e.swap_sig,maker:e.maker,edge:e.edge,fee:{at:e.fee.at,value:e.fee.value,formula:e.fee.formula,components:e.fee.components.map(e=>({at:e.at,name:e.name,type:e.type,value:e.value,percentage:e.percentage,pair:e.pair,amount:e.amount}))},at:e.at,until:e.until,fromMediums:e.from_medium,toMediums:e.to_medium,rate:e.rate,ratio:e.ratio,fromLimits:e.from_limits,toLimits:e.to_limits,createdAt:e.created_at,updatedAt:e.updated_at}}}for(var __rspack_i in exports.BankTransferClient=__webpack_exports__.BankTransferClient,exports.PseClient=__webpack_exports__.PseClient,exports.SwapClient=__webpack_exports__.SwapClient,__webpack_exports__)-1===["BankTransferClient","PseClient","SwapClient"].indexOf(__rspack_i)&&(exports[__rspack_i]=__webpack_exports__[__rspack_i]);Object.defineProperty(exports,"__esModule",{value:!0});

package/dist/index.d.ts

@@ -1,4 +1,6 @@
-export * from './pse/pse-client';
-export * from './pse/types';
-export * from './swap-client';
-export * from './types';
+export { BankTransferClient } from './bank-transfer/bank-transfer-client';
+export type { BankAccountType, BankDepositInformation, CreateBankTransferOrderParams, CreateBankTransferOrderResult, ExecutionHow, ExecutionResult, IdentificationType, KusamaAccountArgs, OrderType, SupportedBank, SwapOrder, } from './bank-transfer/types';
+export { PseClient } from './pse/pse-client';
+export type { Bank, CreatePseOrderParams, CreatePseOrderResult, DepositInformation, ListBanksResult, PseCustomerData, PsePaymentArgs, } from './pse/types';
+export { SwapClient } from './swap-client';
+export type { Fee, FeeComponent, FeeComponentType, FindRatesParams, FindRatesResult, RateLimits, RateTuple, SwapRate, } from './types';

package/dist/index.js

@@ -1 +1 @@
-import{BaseClient as e,BloqueConfigError as t}from"@bloque/sdk-core";class a extends e{async banks(){return{banks:(await this.httpClient.request({method:"GET",path:"/api/utils/pse/banks"})).banks.map(e=>this._mapBankResponse(e))}}async create(e){let a=this.httpClient.urn;if(!a)throw new t("User URN is not available. Please connect to a session first.");let s=e.type??"src",r={taker_urn:a,type:s,rate_sig:e.rateSig,from_medium:"pse",to_medium:e.toMedium,deposit_information:this._mapDepositInformationToWire(e.depositInformation)};"src"===s&&e.amountSrc?r.amount_src=e.amountSrc:"dst"===s&&e.amountDst&&(r.amount_dst=e.amountDst),e.args&&(r.args={bank_code:e.args.bankCode,...e.args.userType&&{user_type:e.args.userType},...e.args.customerEmail&&{customer_email:e.args.customerEmail},...e.args.userLegalIdType&&{user_legal_id_type:e.args.userLegalIdType},...e.args.userLegalId&&{user_legal_id:e.args.userLegalId},...e.args.customerData&&{customer_data:{full_name:e.args.customerData.fullName}}}),e.nodeId&&(r.node_id=e.nodeId),e.metadata&&(r.metadata=e.metadata);let o=await this.httpClient.request({method:"PUT",path:"/api/order",body:r});return{order:this._mapOrderResponse(o.result.order),execution:o.result.execution?this._mapExecutionResult(o.result.execution):void 0,requestId:o.req_id}}_mapBankResponse(e){return{code:e.financial_institution_code,name:e.financial_institution_name}}_mapDepositInformationToWire(e){return{urn:e.urn}}_mapOrderResponse(e){return{id:e.id,orderSig:e.order_sig,rateSig:e.rate_sig,swapSig:e.swap_sig,taker:e.taker,maker:e.maker,fromAsset:e.from_asset,toAsset:e.to_asset,fromMedium:e.from_medium,toMedium:e.to_medium,fromAmount:e.from_amount,toAmount:e.to_amount,at:e.at,graphId:e.graph_id,status:e.status,metadata:e.metadata,createdAt:e.created_at,updatedAt:e.updated_at}}_mapExecutionResult(e){return{nodeId:e.node_id,result:{status:e.result.status,name:e.result.name,description:e.result.description,how:e.result.how,callbackToken:e.result.callback_token}}}}class s extends e{pse;constructor(e){super(e),this.pse=new a(this.httpClient)}async findRates(e){let t=new URLSearchParams,a=JSON.stringify([e.fromAsset,e.toAsset]);t.append("edge",a),t.append("from_medium",JSON.stringify(e.fromMediums)),t.append("to_medium",JSON.stringify(e.toMediums)),void 0!==e.amountSrc&&t.append("amount_src",e.amountSrc),void 0!==e.amountDst&&t.append("amount_dst",e.amountDst),e.sort&&t.append("sort",e.sort),e.sortBy&&t.append("sort_by",e.sortBy);let s=t.toString(),r=`/api/rates?${s}`;return{rates:(await this.httpClient.request({method:"GET",path:r})).rates.map(e=>this._mapRateResponse(e))}}_mapRateResponse(e){return{id:e.id,sig:e.sig,swapSig:e.swap_sig,maker:e.maker,edge:e.edge,fee:{at:e.fee.at,value:e.fee.value,formula:e.fee.formula,components:e.fee.components.map(e=>({at:e.at,name:e.name,type:e.type,value:e.value,percentage:e.percentage,pair:e.pair,amount:e.amount}))},at:e.at,until:e.until,fromMediums:e.from_medium,toMediums:e.to_medium,rate:e.rate,ratio:e.ratio,fromLimits:e.from_limits,toLimits:e.to_limits,createdAt:e.created_at,updatedAt:e.updated_at}}}export{a as PseClient,s as SwapClient};
+import{BaseClient as t,BloqueConfigError as e}from"@bloque/sdk-core";class a extends t{async create(t){let a=this.httpClient.urn;if(!a)throw new e("User URN is not available. Please connect to a session first.");let r=t.type??"src",s={taker_urn:a,type:r,rate_sig:t.rateSig,from_medium:"kusama",to_medium:t.toMedium,deposit_information:this._mapDepositInformationToWire(t.depositInformation)};"src"===r&&t.amountSrc?s.amount_src=t.amountSrc:"dst"===r&&t.amountDst&&(s.amount_dst=t.amountDst),t.args&&(s.args={account_urn:t.args.sourceAccountUrn}),t.nodeId&&(s.node_id=t.nodeId),t.metadata&&(s.metadata=t.metadata);let o=await this.httpClient.request({method:"PUT",path:"/api/order",body:s});return{order:this._mapOrderResponse(o.result.order),execution:o.result.execution?this._mapExecutionResult(o.result.execution):void 0,requestId:o.req_id}}_mapDepositInformationToWire(t){return{bank_account_type:t.bankAccountType,bank_account_number:t.bankAccountNumber,bank_account_holder_name:t.bankAccountHolderName,bank_account_holder_identification_type:t.bankAccountHolderIdentificationType,bank_account_holder_identification_value:t.bankAccountHolderIdentificationValue}}_mapOrderResponse(t){return{id:t.id,orderSig:t.order_sig,rateSig:t.rate_sig,swapSig:t.swap_sig,taker:t.taker,maker:t.maker,fromAsset:t.from_asset,toAsset:t.to_asset,fromMedium:t.from_medium,toMedium:t.to_medium,fromAmount:t.from_amount,toAmount:t.to_amount,at:t.at,graphId:t.graph_id,status:t.status,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at}}_mapExecutionResult(t){return{nodeId:t.node_id,result:{status:t.result.status,name:t.result.name,description:t.result.description,how:t.result.how,callbackToken:t.result.callback_token}}}}class r extends t{async banks(){return{banks:(await this.httpClient.request({method:"GET",path:"/api/utils/pse/banks"})).banks.map(t=>this._mapBankResponse(t))}}async create(t){let a=this.httpClient.urn;if(!a)throw new e("User URN is not available. Please connect to a session first.");let r=t.type??"src",s={taker_urn:a,type:r,rate_sig:t.rateSig,from_medium:"pse",to_medium:t.toMedium,deposit_information:this._mapDepositInformationToWire(t.depositInformation)};"src"===r&&t.amountSrc?s.amount_src=t.amountSrc:"dst"===r&&t.amountDst&&(s.amount_dst=t.amountDst),t.args&&(s.args={bank_code:t.args.bankCode,...t.args.userType&&{user_type:t.args.userType},...t.args.customerEmail&&{customer_email:t.args.customerEmail},...t.args.userLegalIdType&&{user_legal_id_type:t.args.userLegalIdType},...t.args.userLegalId&&{user_legal_id:t.args.userLegalId},...t.args.customerData&&{customer_data:{full_name:t.args.customerData.fullName,phone_number:t.args.customerData.phoneNumber}}}),t.nodeId&&(s.node_id=t.nodeId),t.metadata&&(s.metadata=t.metadata);let o=await this.httpClient.request({method:"PUT",path:"/api/order",body:s});return{order:this._mapOrderResponse(o.result.order),execution:o.result.execution?this._mapExecutionResult(o.result.execution):void 0,requestId:o.req_id}}_mapBankResponse(t){return{code:t.financial_institution_code,name:t.financial_institution_name}}_mapDepositInformationToWire(t){return{urn:t.urn}}_mapOrderResponse(t){return{id:t.id,orderSig:t.order_sig,rateSig:t.rate_sig,swapSig:t.swap_sig,taker:t.taker,maker:t.maker,fromAsset:t.from_asset,toAsset:t.to_asset,fromMedium:t.from_medium,toMedium:t.to_medium,fromAmount:t.from_amount,toAmount:t.to_amount,at:t.at,graphId:t.graph_id,status:t.status,metadata:t.metadata,createdAt:t.created_at,updatedAt:t.updated_at}}_mapExecutionResult(t){return{nodeId:t.node_id,result:{status:t.result.status,name:t.result.name,description:t.result.description,how:t.result.how,callbackToken:t.result.callback_token}}}}class s extends t{pse;bankTransfer;constructor(t){super(t),this.pse=new r(this.httpClient),this.bankTransfer=new a(this.httpClient)}async findRates(t){let e=new URLSearchParams,a=JSON.stringify([t.fromAsset,t.toAsset]);e.append("edge",a),e.append("from_medium",JSON.stringify(t.fromMediums)),e.append("to_medium",JSON.stringify(t.toMediums)),void 0!==t.amountSrc&&e.append("amount_src",t.amountSrc),void 0!==t.amountDst&&e.append("amount_dst",t.amountDst),t.sort&&e.append("sort",t.sort),t.sortBy&&e.append("sort_by",t.sortBy);let r=e.toString(),s=`/api/rates?${r}`;return{rates:(await this.httpClient.request({method:"GET",path:s})).rates.map(t=>this._mapRateResponse(t))}}_mapRateResponse(t){return{id:t.id,sig:t.sig,swapSig:t.swap_sig,maker:t.maker,edge:t.edge,fee:{at:t.fee.at,value:t.fee.value,formula:t.fee.formula,components:t.fee.components.map(t=>({at:t.at,name:t.name,type:t.type,value:t.value,percentage:t.percentage,pair:t.pair,amount:t.amount}))},at:t.at,until:t.until,fromMediums:t.from_medium,toMediums:t.to_medium,rate:t.rate,ratio:t.ratio,fromLimits:t.from_limits,toLimits:t.to_limits,createdAt:t.created_at,updatedAt:t.updated_at}}}export{a as BankTransferClient,r as PseClient,s as SwapClient};

package/dist/internal/wire-types.d.ts

@@ -75,10 +75,24 @@ export interface ListPseBanksResponse {
 export type OrderType = 'src' | 'dst';
 /**
  * @internal
- * Deposit information for PSE top-up
+ * Deposit information for swap orders
  */
 export interface DepositInformation {
-    urn: string;
+    /** PSE deposit URN */
+    urn?: string;
+    /** Bancolombia deposit information */
+    bancolombia?: BancolombiaDepositInformation;
+}
+/**
+ * @internal
+ * Bancolombia deposit information for bank account details
+ */
+export interface BancolombiaDepositInformation {
+    bank_account_type: 'savings' | 'checking';
+    bank_account_number: string;
+    bank_account_holder_name: string;
+    bank_account_holder_identification_type: 'CC' | 'CE' | 'NIT' | 'PP';
+    bank_account_holder_identification_value: string;
 }
 /**
  * @internal
@@ -92,7 +106,7 @@ export interface CreateOrderInput {
     to_medium: string;
     amount_src?: string;
     amount_dst?: string;
-    deposit_information: DepositInformation;
+    deposit_information: DepositInformation | BancolombiaDepositInformation;
     args?: Record<string, unknown>;
     node_id?: string;
     metadata?: Record<string, unknown>;

package/dist/pse/types.d.ts

@@ -1,3 +1,5 @@
+import type { ExecutionHow, ExecutionResult, OrderType, SwapOrder } from '../bank-transfer/types';
+export type { ExecutionHow, ExecutionResult, OrderType, SwapOrder };
 export interface Bank {
     /**
      * Financial institution code
@@ -11,12 +13,6 @@ export interface Bank {
 export interface ListBanksResult {
     banks: Bank[];
 }
-/**
- * Order type for swap
- * - 'src': Taker specifies exact source amount to pay
- * - 'dst': Taker specifies exact destination amount to receive
- */
-export type OrderType = 'src' | 'dst';
 /**
  * Deposit information for PSE top-up
  */
@@ -35,6 +31,10 @@ export interface PseCustomerData {
      * Customer's full name
      */
     fullName: string;
+    /**
+     * Customer's phone number
+     */
+    phoneNumber: string;
 }
 /**
  * PSE payment arguments for auto-execution
@@ -45,25 +45,25 @@ export interface PsePaymentArgs {
      */
     bankCode: string;
     /**
-     * User type: 'natural' for natural person, 'juridica' for legal entity
+     * User type: 0 for natural person, 1 for legal entity
      */
-    userType?: 'natural' | 'juridica';
+    userType: 0 | 1;
     /**
      * Customer email address
      */
-    customerEmail?: string;
+    customerEmail: string;
     /**
      * User legal ID type (e.g., 'CC', 'NIT', 'CE')
      */
-    userLegalIdType?: 'CC' | 'NIT' | 'CE';
+    userLegalIdType: 'CC' | 'NIT' | 'CE';
     /**
      * User legal ID number
      */
-    userLegalId?: string;
+    userLegalId: string;
     /**
      * Additional customer data
      */
-    customerData?: PseCustomerData;
+    customerData: PseCustomerData;
 }
 /**
  * Parameters for creating a PSE swap order
@@ -97,7 +97,7 @@ export interface CreatePseOrderParams {
     /**
      * PSE payment arguments for auto-execution
      */
-    args?: PsePaymentArgs;
+    args: PsePaymentArgs;
     /**
      * Specific node ID to execute (defaults to first node)
      */
@@ -107,130 +107,6 @@ export interface CreatePseOrderParams {
      */
     metadata?: Record<string, unknown>;
 }
-/**
- * Swap order details
- */
-export interface SwapOrder {
-    /**
-     * Unique order identifier
-     */
-    id: string;
-    /**
-     * Order signature
-     */
-    orderSig: string;
-    /**
-     * Rate signature used for this order
-     */
-    rateSig: string;
-    /**
-     * Swap signature
-     */
-    swapSig: string;
-    /**
-     * Taker URN
-     */
-    taker: string;
-    /**
-     * Maker URN
-     */
-    maker: string;
-    /**
-     * Source asset
-     */
-    fromAsset: string;
-    /**
-     * Destination asset
-     */
-    toAsset: string;
-    /**
-     * Source medium
-     */
-    fromMedium: string;
-    /**
-     * Destination medium
-     */
-    toMedium: string;
-    /**
-     * Source amount
-     */
-    fromAmount: string;
-    /**
-     * Destination amount
-     */
-    toAmount: string;
-    /**
-     * Timestamp when the order was created (as string)
-     */
-    at: string;
-    /**
-     * Instruction graph ID for tracking execution
-     */
-    graphId: string;
-    /**
-     * Order status (pending, in_progress, completed, failed)
-     */
-    status: string;
-    /**
-     * Additional metadata
-     */
-    metadata?: Record<string, unknown>;
-    /**
-     * Creation timestamp
-     */
-    createdAt: string;
-    /**
-     * Last update timestamp
-     */
-    updatedAt: string;
-}
-/**
- * Redirect instructions for completing the payment
- */
-export interface ExecutionHow {
-    /**
-     * Type of action required (e.g., "REDIRECT")
-     */
-    type: string;
-    /**
-     * URL to redirect the user to complete the payment
-     */
-    url: string;
-}
-/**
- * Execution result from auto-execution
- */
-export interface ExecutionResult {
-    /**
-     * Node ID that was executed
-     */
-    nodeId: string;
-    /**
-     * Execution result details
-     */
-    result: {
-        /**
-         * Execution status (e.g., "paused")
-         */
-        status: string;
-        /**
-         * Name of the current step
-         */
-        name?: string;
-        /**
-         * Description of what the user needs to do
-         */
-        description?: string;
-        /**
-         * Instructions for completing this step
-         */
-        how?: ExecutionHow;
-        /**
-         * Callback token for tracking
-         */
-        callbackToken?: string;
-    };
-}
 /**
  * Result of creating a PSE swap order
  */

package/dist/swap-client.d.ts

@@ -1,5 +1,6 @@
 import type { HttpClient } from '@bloque/sdk-core';
 import { BaseClient } from '@bloque/sdk-core';
+import { BankTransferClient } from './bank-transfer/bank-transfer-client';
 import { PseClient } from './pse/pse-client';
 import type { FindRatesParams, FindRatesResult } from './types';
 /**
@@ -7,9 +8,11 @@ import type { FindRatesParams, FindRatesResult } from './types';
  *
  * Provides access to exchange rate discovery and swapping functionality.
  * - pse: PSE utilities (bank listing, etc.)
+ * - bankTransfer: Generic bank transfer cash-out (supports all Colombian banks)
  */
 export declare class SwapClient extends BaseClient {
     readonly pse: PseClient;
+    readonly bankTransfer: BankTransferClient;
     constructor(httpClient: HttpClient);
     /**
      * Find available exchange rates

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bloque/sdk-swap",
-  "version": "0.0.32",
+  "version": "0.0.34",
   "type": "module",
   "keywords": [
     "bloque",
@@ -34,6 +34,6 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@bloque/sdk-core": "0.0.32"
+    "@bloque/sdk-core": "0.0.34"
   }
 }