genius-intents 0.1.4

package/dist/src/protocols/aftermath/aftermath.types.d.ts

@@ -0,0 +1,100 @@
+export type AftermathConfig = {
+    suiRpcUrl: string;
+    privateUrl?: string;
+    quoteParamOverrides?: Partial<AftermathSwapParams>;
+};
+export type AftermathPriceParams = {
+    /**
+     * Required token type for the input token
+     * The token the user is swapping from
+     */
+    coinInType: string;
+    /**
+     * Required token type for the output token
+     * The token the user is swapping to
+     */
+    coinOutType: string;
+    /**
+     * Required amount to swap (as BigInt or string)
+     */
+    coinInAmount: BigInt | string;
+    /**
+     * Slippage tolerance as a decimal (0.01 = 1%)
+     */
+    slippage?: number;
+    /**
+     * Optional external fee configuration
+     */
+    externalFee?: {
+        recipient: string;
+        feePercentage: number;
+    };
+};
+export type AftermathRoutePool = {
+    poolId: string;
+    poolType: string;
+    tokenXType: string;
+    tokenYType: string;
+    fee: string;
+    tickSpacing?: number;
+};
+export type AftermathRouteStep = {
+    pool: AftermathRoutePool;
+    tokenIn: string;
+    tokenOut: string;
+    amountIn: string;
+    amountOut: string;
+    feeAmount: string;
+};
+export type AftermathRoute = {
+    steps: AftermathRouteStep[];
+    inputToken: string;
+    outputToken: string;
+    totalAmountIn: string;
+    totalAmountOut: string;
+    priceImpact: string;
+    gasEstimate?: string;
+};
+export type AftermathSwapParams = {
+    /**
+     * Required wallet address of the user initiating the swap
+     */
+    walletAddress: string;
+    /**
+     * Complete route information from the price response
+     */
+    completeRoute: AftermathRoute;
+    /**
+     * Slippage tolerance as a decimal (0.01 = 1%)
+     */
+    slippage: number;
+    /**
+     * Whether the transaction is sponsored
+     */
+    isSponsoredTx?: boolean;
+};
+export type AftermathPriceResponse = {
+    inToken: string;
+    outToken: string;
+    inAmount: string;
+    outAmount: string;
+    inTokenTradeFee: string;
+    outTokenTradeFee: string;
+    spotPrice: string;
+    route: AftermathRoute;
+    slippage: number;
+};
+export type AftermathTransactionData = {
+    transactionBlock: string;
+    lastValidBlockHeight?: number;
+    gasEstimate?: {
+        computationCost: string;
+        storageCost: string;
+        storageRebate: string;
+        totalGas: string;
+    };
+};
+export type AftermathQuoteResponse = {
+    transactions: string[];
+};
+//# sourceMappingURL=aftermath.types.d.ts.map

package/dist/src/protocols/aftermath/aftermath.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aftermath.types.d.ts","sourceRoot":"","sources":["../../../../src/protocols/aftermath/aftermath.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACpD,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH,CAAC;AAGF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,aAAa,EAAE,cAAc,CAAC;IAE9B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,WAAW,CAAC,EAAE;QACZ,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC"}

package/dist/src/protocols/aftermath/aftermath.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=aftermath.types.js.map

package/dist/src/protocols/aftermath/aftermath.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aftermath.types.js","sourceRoot":"","sources":["../../../../src/protocols/aftermath/aftermath.types.ts"],"names":[],"mappings":""}

package/dist/src/protocols/aftermath/index.d.ts

@@ -0,0 +1,3 @@
+export { AftermathService } from './aftermath.service';
+export type { AftermathConfig, AftermathPriceParams, AftermathRoutePool, AftermathRouteStep, AftermathRoute, AftermathSwapParams, AftermathPriceResponse, AftermathTransactionData, AftermathQuoteResponse, } from './aftermath.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/protocols/aftermath/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/protocols/aftermath/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC"}

package/dist/src/protocols/aftermath/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AftermathService = void 0;
+// Aftermath Protocol - All exports
+var aftermath_service_1 = require("./aftermath.service");
+Object.defineProperty(exports, "AftermathService", { enumerable: true, get: function () { return aftermath_service_1.AftermathService; } });
+//# sourceMappingURL=index.js.map

package/dist/src/protocols/aftermath/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/protocols/aftermath/index.ts"],"names":[],"mappings":";;;AAAA,mCAAmC;AACnC,yDAAuD;AAA9C,qHAAA,gBAAgB,OAAA"}

package/dist/src/protocols/debridge/debridge.service.d.ts

@@ -0,0 +1,157 @@
+import { DeBridgeConfig, DeBridgeQuoteResponse, DeBridgePriceParams, DeBridgeQuoteParams } from './debridge.types';
+import { IIntentProtocol } from '../../interfaces/intent-protocol';
+import { IntentPriceParams } from '../../types/price-params';
+import { PriceResponse, RawProtocolPriceResponse } from '../../types/price-response';
+import { IntentQuoteParams } from '../../types/quote-params';
+import { QuoteResponse } from '../../types/quote-response';
+import { IntentsSDKConfig } from '../../types/sdk-config';
+import { ChainIdEnum, ProtocolEnum } from '../../types/enums';
+/**
+ * The `DeBridgeService` class implements the IIntentProtocol interface for cross-chain
+ * token swaps using the DeBridge protocol. It provides functionality for fetching price
+ * quotes and generating transaction data for token transfers across multiple supported
+ * blockchains.
+ *
+ * @implements {IIntentProtocol}
+ */
+export declare class DeBridgeService implements IIntentProtocol {
+    /**
+     * RPC URLs for each supported blockchain network.
+     */
+    protected readonly rpcUrls: Record<number, string | string[]>;
+    /**
+     * The protocol identifier for DeBridge.
+     */
+    readonly protocol = ProtocolEnum.DEBRIDGE;
+    /**
+     * The list of blockchain networks supported by the DeBridge service.
+     */
+    readonly chains: ChainIdEnum[];
+    /**
+     * Indicates that the service does not operate only on a single blockchain.
+     */
+    readonly singleChain = false;
+    /**
+     * Indicates that the service supports cross-chain operations.
+     */
+    readonly multiChain = true;
+    /**
+     * The base URL for the DeBridge API.
+     */
+    readonly baseUrl: string;
+    /**
+     * The chain ID used for Solana in the DeBridge protocol.
+     */
+    readonly solanaChainIdEnum: number;
+    /**
+     * The chain ID used for Sonic in the DeBridge protocol.
+     */
+    readonly sonicChainIdEnum: number;
+    /**
+     * Optional access token for the DeBridge API.
+     */
+    readonly debridgeAccessToken: string | null;
+    /**
+     * Creates a new instance of the DeBridgeService.
+     *
+     * @param {IntentsSDKConfig & DeBridgeConfig} config - Configuration parameters for the service.
+     *
+     * @throws {SdkError} If no RPC URLs are provided for the supported blockchains.
+     */
+    constructor(config?: IntentsSDKConfig & DeBridgeConfig);
+    isCorrectConfig<T extends {
+        [key: string]: string;
+    }>(config: {
+        [key: string]: string;
+    }): config is T;
+    /**
+     * Fetches a price quote for a cross-chain token swap from the DeBridge API.
+     *
+     * @param {IntentPriceParams} params - The parameters required for the price quote.
+     *
+     * @returns {Promise<PriceResponse>} A promise that resolves to a `PriceResponse` object containing:
+     * - The amount of output tokens expected from the swap.
+     * - The raw response from the DeBridge API.
+     *
+     * @throws {SdkError} If the parameters are invalid or unsupported.
+     * @throws {SdkError} If there's an error fetching the price from DeBridge.
+     */
+    fetchPrice(params: IntentPriceParams): Promise<PriceResponse>;
+    /**
+     * Fetches a swap quote from the DeBridge API and builds the transaction data
+     * needed to execute the cross-chain swap.
+     *
+     * @param {IntentQuoteParams} params - The parameters required for the swap quote.
+     *
+     * @returns {Promise<QuoteResponse>} A promise that resolves to a `QuoteResponse` object containing:
+     * - The expected amount of output tokens.
+     * - The transaction data needed to execute the swap.
+     *
+     * @throws {SdkError} If the parameters are invalid or unsupported.
+     * @throws {SdkError} If the DeBridge API returns an invalid response.
+     * @throws {SdkError} If there's an error fetching the quote.
+     */
+    fetchQuote(params: IntentQuoteParams): Promise<QuoteResponse>;
+    /**
+     * Converts a hexadecimal string representing a serialized transaction into a base58-encoded string.
+     *
+     * This method first decodes the input hex string into a buffer, deserializes it into a `VersionedTransaction`,
+     * then serializes the transaction and encodes the result using base58.
+     *
+     * @param hex - The hexadecimal string to convert. May optionally start with '0x'.
+     * @returns The base58-encoded string representation of the serialized transaction.
+     */
+    formatSolanaTransaction(hex: string): Promise<string>;
+    /**
+     * Fetches a quote from the DeBridge DLN (Decentralized Liquidity Network) API.
+     *
+     * @param {DeBridgePriceParams & { to?: string; authority?: { networkInAddress: string; networkOutAddress: string; }}} params -
+     * The parameters for the quote request, including network IDs, token addresses, amounts, and authority addresses.
+     *
+     * @returns {Promise<DeBridgeQuoteResponse>} A promise that resolves to the quote response from DeBridge.
+     *
+     * @throws {SdkError} If there's an error with the HTTP request to the DeBridge API.
+     * @throws {Error} If the DeBridge API returns an error message.
+     */
+    protected fetchDLNQuote(params: DeBridgePriceParams & {
+        to?: string;
+        authority?: {
+            networkInAddress: string;
+            networkOutAddress: string;
+        };
+    }): Promise<DeBridgeQuoteResponse>;
+    /**
+     * Validates the parameters for a price quote request.
+     *
+     * @param {IntentPriceParams} params - The parameters to validate.
+     *
+     * @throws {SdkError} If any of the parameters are invalid or unsupported.
+     */
+    protected validatePriceParams(params: IntentPriceParams): void;
+    /**
+     * Validates the parameters for a quote request, extending the price parameters validation.
+     *
+     * @param {IntentQuoteParams} params - The parameters to validate.
+     *
+     * @throws {SdkError} If any of the parameters are invalid or missing.
+     */
+    protected validateQuoteParams(params: IntentQuoteParams): void;
+    /**
+     * Transforms the price parameters to the format expected by the DeBridge API.
+     *
+     * @param {IntentPriceParams} params - The original price parameters.
+     *
+     * @returns {DeBridgePriceParams} The transformed parameters ready for the DeBridge API.
+     */
+    protected transformPriceParams(params: IntentPriceParams): DeBridgePriceParams;
+    /**
+     * Transforms the quote parameters to the format expected by the DeBridge API.
+     *
+     * @param {IntentQuoteParams} params - The original quote parameters.
+     *
+     * @returns {DeBridgeQuoteParams} The transformed parameters ready for the DeBridge API.
+     */
+    protected transformQuoteParams(params: IntentQuoteParams): DeBridgeQuoteParams;
+    protected isDeBridgePriceResponse(response: RawProtocolPriceResponse): response is DeBridgeQuoteResponse;
+}
+//# sourceMappingURL=debridge.service.d.ts.map

package/dist/src/protocols/debridge/debridge.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debridge.service.d.ts","sourceRoot":"","sources":["../../../../src/protocols/debridge/debridge.service.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAS1D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAgB,MAAM,mBAAmB,CAAC;AAI5E;;;;;;;GAOG;AACH,qBAAa,eAAgB,YAAW,eAAe;IACrD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAM;IAEnE;;OAEG;IACH,SAAgB,QAAQ,yBAAyB;IAEjD;;OAEG;IACH,SAAgB,MAAM,gBAWpB;IAEF;;OAEG;IACH,SAAgB,WAAW,SAAS;IAEpC;;OAEG;IACH,SAAgB,UAAU,QAAQ;IAElC;;OAEG;IACH,SAAgB,OAAO,EAAE,MAAM,CAAC;IAEhC;;OAEG;IACH,SAAgB,iBAAiB,EAAE,MAAM,CAAW;IAEpD;;OAEG;IACH,SAAgB,gBAAgB,EAAE,MAAM,CAAa;IAErD;;OAEG;IACH,SAAgB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE1D;;;;;;OAMG;gBACS,MAAM,CAAC,EAAE,gBAAgB,GAAG,cAAc;IAgBtD,eAAe,CAAC,CAAC,SAAS;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,EAAE,MAAM,EAAE;QAC3D,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;KACvB,GAAG,MAAM,IAAI,CAAC;IAKf;;;;;;;;;;;OAWG;IACU,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IAkC1E;;;;;;;;;;;;;OAaG;IACU,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IAmE1E;;;;;;;;OAQG;IACU,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAsBlE;;;;;;;;;;OAUG;cACa,aAAa,CAC3B,MAAM,EAAE,mBAAmB,GAAG;QAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE;YACV,gBAAgB,EAAE,MAAM,CAAC;YACzB,iBAAiB,EAAE,MAAM,CAAC;SAC3B,CAAC;KACH,GACA,OAAO,CAAC,qBAAqB,CAAC;IAsEjC;;;;;;OAMG;IACH,SAAS,CAAC,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAmE9D;;;;;;OAMG;IACH,SAAS,CAAC,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAc9D;;;;;;OAMG;IACH,SAAS,CAAC,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,mBAAmB;IAwC9E;;;;;;OAMG;IACH,SAAS,CAAC,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,mBAAmB;IAqB9E,SAAS,CAAC,uBAAuB,CAC/B,QAAQ,EAAE,wBAAwB,GACjC,QAAQ,IAAI,qBAAqB;CAGrC"}