@shogun-sdk/intents-sdk 1.0.0

package/dist/_types/core/sui/sdk.d.ts

@@ -0,0 +1,55 @@
+import type { SuiConfig } from '../../config.js';
+import type { PreparedOrder } from '../../types/intent.js';
+import { Order } from '../order.js';
+import { BaseSDK } from '../sdk.js';
+/**
+ * Sui-specific SDK implementation
+ *
+ * Handles Sui-specific aspects of cross-chain swaps using the Sui blockchain.
+ * Uses @mysten/sui libraries for transaction creation, signing, and submission.
+ * Supports cross-chain swaps from Sui to other supported chains.
+ */
+export declare class SuiSDK extends BaseSDK {
+    /** Configuration for Sui connection and authentication */
+    private readonly config;
+    /** Client for Sui RPC interactions and transaction handling */
+    private client;
+    /**
+     * Creates a new instance of the Sui SDK
+     *
+     * @param config Sui configuration including privateKey and optional RPC URL
+     */
+    constructor(config: SuiConfig);
+    /**
+     * Gets the user's Sui wallet address derived from their private key
+     *
+     * Uses Ed25519Keypair to securely derive the wallet address from the private key
+     *
+     * @returns Promise resolving to the user's Sui address as a hex string
+     */
+    getUserAddress(): Promise<string>;
+    /**
+     * Creates an Ed25519Keypair from the user's private key
+     *
+     * The keypair is used for transaction signing and address derivation
+     *
+     * @returns Ed25519Keypair for cryptographic operations
+     * @private
+     */
+    private getKeyPair;
+    /**
+     * Prepares a Sui order for submission
+     *
+     * This method:
+     * 1. Gets the user's keypair from their private key
+     * 2. Generates Sui-specific transaction for the order
+     * 3. Signs and executes the transaction on the Sui blockchain
+     * 4. Returns the prepared order with the transaction hash for tracking
+     *
+     * @param order The validated order to prepare
+     * @returns Promise resolving to a prepared order with Sui-specific data
+     * @protected
+     */
+    protected prepareOrder(order: Order): Promise<PreparedOrder>;
+}
+//# sourceMappingURL=sdk.d.ts.map

package/dist/_types/core/sui/sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../../../src/core/sui/sdk.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC;;;;;;GAMG;AACH,qBAAa,MAAO,SAAQ,OAAO;IACjC,0DAA0D;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,+DAA+D;IAC/D,OAAO,CAAC,MAAM,CAAY;IAE1B;;;;OAIG;gBACS,MAAM,EAAE,SAAS;IAM7B;;;;;;OAMG;IACU,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAI9C;;;;;;;OAOG;IACH,OAAO,CAAC,UAAU;IAIlB;;;;;;;;;;;;OAYG;cACa,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,aAAa,CAAC;CAuBnE"}

package/dist/_types/core/sui/validator.d.ts

@@ -0,0 +1,9 @@
+import { BaseValidator } from '../../utils/base-validator.js';
+export declare class SuiValidator extends BaseValidator {
+    isValidAddress(address: string): boolean;
+    isValidTokenAddress(tokenAddress: string): boolean;
+    isValidAmount(amount: bigint): boolean;
+    protected getChainName(): string;
+    chainSpecificValidation(): Promise<void>;
+}
+//# sourceMappingURL=validator.d.ts.map

package/dist/_types/core/sui/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../../src/core/sui/validator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAI9D,qBAAa,YAAa,SAAQ,aAAa;IAC7C,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIxC,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAQlD,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAItC,SAAS,CAAC,YAAY,IAAI,MAAM;IAInB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;CAItD"}

package/dist/_types/errors/index.d.ts

@@ -0,0 +1,32 @@
+export declare class BaseError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+    toJSON(): Record<string, unknown>;
+    private formatCause;
+}
+export declare class EVMError extends BaseError {
+    constructor(message: string, cause?: unknown);
+}
+export declare class SolanaError extends BaseError {
+    constructor(message: string, cause?: unknown);
+}
+export declare class SuiError extends BaseError {
+    constructor(message: string, cause?: unknown);
+}
+export declare class ValidationError extends BaseError {
+    constructor(message: string, cause?: unknown);
+}
+export declare class OrderCreationError extends BaseError {
+    constructor(message: string, cause?: unknown);
+}
+export declare class NetworkError extends BaseError {
+    constructor(message: string, cause?: unknown);
+}
+export declare class InsufficientBalanceError extends BaseError {
+    constructor(message: string, cause?: unknown);
+}
+export declare class InsufficientAllowanceError extends BaseError {
+    constructor(message: string, cause?: unknown);
+}
+export declare function handleError(error: unknown): BaseError;
+//# sourceMappingURL=index.d.ts.map

package/dist/_types/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"AAAA,qBAAa,SAAU,SAAQ,KAAK;aAGP,KAAK,CAAC,EAAE,OAAO;gBADxC,OAAO,EAAE,MAAM,EACU,KAAK,CAAC,EAAE,OAAO,YAAA;IAQnC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAQxC,OAAO,CAAC,WAAW;CAapB;AAGD,qBAAa,QAAS,SAAQ,SAAS;gBACzB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C;AAED,qBAAa,WAAY,SAAQ,SAAS;gBAC5B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C;AAED,qBAAa,QAAS,SAAQ,SAAS;gBACzB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C;AAGD,qBAAa,eAAgB,SAAQ,SAAS;gBAChC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C;AAED,qBAAa,kBAAmB,SAAQ,SAAS;gBACnC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C;AAED,qBAAa,YAAa,SAAQ,SAAS;gBAC7B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C;AAED,qBAAa,wBAAyB,SAAQ,SAAS;gBACzC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C;AAED,qBAAa,0BAA2B,SAAQ,SAAS;gBAC3C,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C;AACD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAcrD"}

package/dist/_types/index.d.ts

@@ -0,0 +1,10 @@
+export type { ChainID, ChainType } from './chains.js';
+export { SupportedChains } from './chains.js';
+export type { EVMConfig, SolanaConfig, SuiConfig } from './config.js';
+export { EVMSDK } from './core/evm/sdk.js';
+export { Order } from './core/order.js';
+export { SolanaSDK } from './core/solana/sdk.js';
+export { SuiSDK } from './core/sui/sdk.js';
+export { ValidationError } from './errors/index.js';
+export type { CreateOrderParams } from './types/intent.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/_types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/_types/types/intent.d.ts

@@ -0,0 +1,129 @@
+import type { SupportedChain } from '../chains.js';
+import type { ExtraTransfer, Order } from '../core/order.js';
+/**
+ * Parameters for creating a cross-chain order
+ * Used as input for the createOrder and createAndSendOrder methods
+ */
+export type CreateOrderParams = {
+    /** Chain ID where tokens will be sent from */
+    sourceChainId: SupportedChain;
+    /** Token address on the source chain to be swapped */
+    sourceTokenAddress: string;
+    /** Amount of source tokens to swap, in smallest units (e.g., Wei for ETH) */
+    sourceTokenAmount: bigint;
+    /** Chain ID where tokens will be received */
+    destinationChainId: SupportedChain;
+    /** Token address on the destination chain to receive */
+    destinationTokenAddress: string;
+    /** Minimum amount of destination tokens to receive, in smallest units */
+    destinationTokenMinAmount: bigint;
+    /** Recipient wallet address on the destination chain */
+    destinationAddress: string;
+    /** Minimum amount of stablecoins in the intermediate swap, in smallest units */
+    minStablecoinAmount: bigint;
+    /** Timestamp (in seconds) after which the order expires */
+    deadline: number;
+    /** Extra Transfers */
+    extraTransfers?: ExtraTransfer[];
+};
+/**
+ * Details required to execute the order on the destination chain
+ * Contains all information needed for the cross-chain fulfillment
+ */
+export type ExecutionDetails = {
+    /** Chain ID where tokens will be received */
+    destChainId: SupportedChain;
+    /** Token address on the destination chain to receive */
+    tokenOut: string;
+    /** Minimum amount of destination tokens to receive, in smallest units */
+    amountOutMin: bigint;
+    /** Recipient wallet address on the destination chain */
+    destinationAddress: string;
+    /** Extra transfers to be made */
+    extraTransfers?: ExtraTransfer[];
+};
+/** Hex string with 0x prefix, used for various hashes */
+export type Hash = `0x${string}`;
+/** Hash of execution details, used to verify order integrity across chains */
+export type ExecutionDetailsHash = Hash;
+/**
+ * EVM-specific data required for prepared orders
+ * Contains the signature and nonce for Permit2 allowance
+ */
+export type EvmPreparedData = {
+    /** Random nonce for Permit2 signature, prevents replay attacks */
+    nonce: string;
+    /** EIP-712 signature authorizing the order */
+    signature: string | Hash;
+};
+/**
+ * Sui-specific data required for prepared orders
+ * Contains the transaction hash of the order creation transaction
+ */
+export type SuiPreparedData = {
+    /** Transaction hash of the successful order creation transaction */
+    transactionHash: string;
+};
+/**
+ * Solana-specific data required for prepared orders
+ * Contains the public key of the created order account
+ */
+export type SolanaPreparedData = {
+    /** Public key of the created order account on Solana */
+    orderPubkey: string;
+};
+/**
+ * Source chain data sent to the auctioneer
+ * Contains all information needed to start the cross-chain swap from the source chain
+ */
+export type SourceChainData = {
+    /** User's wallet address that initiated the order */
+    user: string;
+    /** Source chain ID where tokens will be sent from */
+    srcChainId: SupportedChain;
+    /** Token address on the source chain to be swapped */
+    tokenIn: string;
+    /** Amount of source tokens to swap, in smallest units */
+    amountIn: bigint;
+    /** Minimum amount of stablecoins in the intermediate swap, in smallest units */
+    minStablecoinsAmount: bigint;
+    /** Timestamp (in seconds) after which the order expires */
+    deadline: number;
+    /** Hash of execution details for cross-chain verification */
+    executionDetailsHash: ExecutionDetailsHash;
+};
+/**
+ * Complete user intent request sent to the auctioneer service
+ * Contains all the information needed to execute the cross-chain swap
+ */
+export type UserIntentRequest = {
+    /** Generic data common to all chains */
+    genericData: SourceChainData;
+    /** JSON-stringified execution details for the destination chain */
+    executionDetails: string;
+    /** Chain-specific data including signatures and transaction details */
+    chainSpecificData: {
+        /** EVM-specific data (for Ethereum, Arbitrum, Optimism, Base) */
+        EVM?: EvmPreparedData;
+        /** Solana-specific data */
+        Solana?: SolanaPreparedData;
+        /** Sui-specific data */
+        Sui?: SolanaPreparedData;
+    };
+};
+/**
+ * Union type of all chain-specific prepared data
+ * The actual type depends on the source chain
+ */
+export type ChainPreparedData = EvmPreparedData | SuiPreparedData | SolanaPreparedData;
+/**
+ * Fully prepared order ready for submission to the auctioneer
+ * Contains both the order details and chain-specific prepared data
+ */
+export type PreparedOrder = {
+    /** The original order with all cross-chain details */
+    order: Order;
+    /** Chain-specific data needed for order execution */
+    preparedData: ChainPreparedData;
+};
+//# sourceMappingURL=intent.d.ts.map

package/dist/_types/types/intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../../src/types/intent.ts"],"names":[],"mappings":"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"}

package/dist/_types/utils/base-validator.d.ts

@@ -0,0 +1,28 @@
+import type { OrderInput } from '../core/order.js';
+import type { IChainValidator } from './order-validator.js';
+/**
+ * BaseValidator - Abstract class implementing common validation logic
+ * This follows the Template Method pattern
+ */
+export declare abstract class BaseValidator implements IChainValidator {
+    abstract isValidAddress(address: string): boolean;
+    abstract isValidTokenAddress(tokenAddress: string): boolean;
+    abstract isValidAmount(amount: bigint): boolean;
+    protected abstract getChainName(): string;
+    abstract chainSpecificValidation(order: OrderInput): Promise<void>;
+    /**
+     * Validate source chain specific parameters of the order
+     */
+    validateSourceChain(order: OrderInput): Promise<void>;
+    /**
+     * Validate destination chain specific parameters of the order
+     */
+    validateDestinationChain(order: OrderInput): void;
+    /**
+     * Helper methods that throw specific validation errors
+     */
+    protected validateAddress(address: string): void;
+    protected validateTokenAddress(tokenAddress: string): void;
+    protected validateAmount(amount: bigint): void;
+}
+//# sourceMappingURL=base-validator.d.ts.map

package/dist/_types/utils/base-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-validator.d.ts","sourceRoot":"","sources":["../../../src/utils/base-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;GAGG;AACH,8BAAsB,aAAc,YAAW,eAAe;IAC5D,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IACjD,QAAQ,CAAC,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAC3D,QAAQ,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAC/C,SAAS,CAAC,QAAQ,CAAC,YAAY,IAAI,MAAM;IACzC,QAAQ,CAAC,uBAAuB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAElE;;OAEG;IACG,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3D;;OAEG;IACH,wBAAwB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAcjD;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMhD,SAAS,CAAC,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAM1D,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAK/C"}

package/dist/_types/utils/logger.d.ts

@@ -0,0 +1,35 @@
+export declare enum LogLevel {
+    DEBUG = "DEBUG",
+    INFO = "INFO",
+    WARN = "WARN",
+    ERROR = "ERROR",
+    NONE = "NONE"
+}
+export type LoggerConfig = {
+    level: LogLevel;
+    customLogger?: CustomLogger;
+};
+export interface CustomLogger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+declare class Logger {
+    private static instance;
+    private loggerImpl;
+    private logLevel;
+    private constructor();
+    static getInstance(): Logger;
+    configure(config: LoggerConfig): void;
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, error?: unknown): void;
+    logError(error: unknown): void;
+    private shouldLog;
+    private formatError;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/_types/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,oBAAY,QAAQ;IAClB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;IACf,IAAI,SAAS;CACd;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,QAAQ,CAAC;IAChB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAClD;AAoBD,cAAM,MAAM;IACV,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAS;IAChC,OAAO,CAAC,UAAU,CAAqC;IACvD,OAAO,CAAC,QAAQ,CAA2B;IAE3C,OAAO;WAEO,WAAW,IAAI,MAAM;IAO5B,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAOrC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAO7C,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAcrC,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,WAAW;CAiBpB;AAED,eAAO,MAAM,MAAM,QAAuB,CAAC"}

package/dist/_types/utils/order-validator.d.ts

@@ -0,0 +1,40 @@
+import { ChainType, type SupportedChain } from '../chains.js';
+import type { OrderInput } from '../core/order.js';
+export interface IAddressValidator {
+    isValidAddress(address: string): boolean;
+}
+export interface ITokenValidator {
+    isValidTokenAddress(tokenAddress: string): boolean;
+}
+export interface IAmountValidator {
+    isValidAmount(amount: bigint): boolean;
+}
+export interface IDeadlineValidator {
+    isValidDeadline(deadline: number): boolean;
+}
+export interface ICrossChainValidator {
+    isValidCrossChain(sourceChainId: SupportedChain, destinationChainId: SupportedChain): boolean;
+}
+export interface IChainValidator extends IAddressValidator, ITokenValidator, IAmountValidator {
+    validateSourceChain(order: OrderInput): Promise<void>;
+    validateDestinationChain(order: OrderInput): void;
+}
+/**
+ * CommonValidator - Handles validations shared across chains
+ */
+export declare class CommonValidator implements IDeadlineValidator, ICrossChainValidator {
+    isValidDeadline(deadline: number): boolean;
+    validateDeadline(deadline: number): void;
+    isValidCrossChain(sourceChainId: SupportedChain, destinationChainId: SupportedChain): boolean;
+    validateCrossChain(sourceChainId: SupportedChain, destinationChainId: SupportedChain): void;
+}
+export declare class ValidatorFactory {
+    private static validators;
+    static getValidator(chainType: ChainType): IChainValidator;
+    static getValidatorForChain(chainId: SupportedChain): IChainValidator;
+}
+export declare class OrderValidator {
+    private readonly commonValidator;
+    validateOrder(order: OrderInput): Promise<void>;
+}
+//# sourceMappingURL=order-validator.d.ts.map

package/dist/_types/utils/order-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-validator.d.ts","sourceRoot":"","sources":["../../../src/utils/order-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAyB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAErF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAKnD,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1C;AAED,MAAM,WAAW,eAAe;IAC9B,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;CACpD;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;CACxC;AAED,MAAM,WAAW,kBAAkB;IACjC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5C;AAED,MAAM,WAAW,oBAAoB;IACnC,iBAAiB,CAAC,aAAa,EAAE,cAAc,EAAE,kBAAkB,EAAE,cAAc,GAAG,OAAO,CAAC;CAC/F;AAED,MAAM,WAAW,eAAgB,SAAQ,iBAAiB,EAAE,eAAe,EAAE,gBAAgB;IAC3F,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,wBAAwB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;CACnD;AAED;;GAEG;AACH,qBAAa,eAAgB,YAAW,kBAAkB,EAAE,oBAAoB;IAC9E,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI1C,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAMxC,iBAAiB,CAAC,aAAa,EAAE,cAAc,EAAE,kBAAkB,EAAE,cAAc,GAAG,OAAO;IAI7F,kBAAkB,CAAC,aAAa,EAAE,cAAc,EAAE,kBAAkB,EAAE,cAAc,GAAG,IAAI;CAK5F;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,UAAU,CAA8C;IAEvE,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,eAAe;IAoB1D,MAAM,CAAC,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,eAAe;CAItE;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyB;IAEnD,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAatD"}

package/dist/_types/utils/parsers.d.ts

@@ -0,0 +1,4 @@
+export declare namespace Parsers {
+    function bigIntReplacer(_key: string, value: any): any;
+}
+//# sourceMappingURL=parsers.d.ts.map

package/dist/_types/utils/parsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsers.d.ts","sourceRoot":"","sources":["../../../src/utils/parsers.ts"],"names":[],"mappings":"AAEA,yBAAiB,OAAO,CAAC;IAEvB,SAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,GAAG,CAE5D;CACF"}

package/dist/_types/utils/type-utils.d.ts

@@ -0,0 +1,2 @@
+export type TupleToUnion<ArrayType> = ArrayType extends readonly unknown[] ? ArrayType[number] : never;
+//# sourceMappingURL=type-utils.d.ts.map

package/dist/_types/utils/type-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-utils.d.ts","sourceRoot":"","sources":["../../../src/utils/type-utils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,CAAC,SAAS,IAAI,SAAS,SAAS,SAAS,OAAO,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@shogun-sdk/intents-sdk",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Shogun Network Intent-based cross-chain swaps SDK",
+  "author": "Shogun network",
+  "license": "ISC",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/shogun-network/shogun-sdk.git"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/_types/index.d.ts",
+      "default": "./dist/_esm/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "module": "./dist/_esm/index.js",
+  "types": "./dist/_types/index.d.ts",
+  "typings": "./dist/_types/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "dist/**",
+    "!dist/**/*.tsbuildinfo",
+    "src/**/*.ts",
+    "!src/**/*.test.ts",
+    "!src/**/*.test-d.ts",
+    "README.md"
+  ],
+  "keywords": [
+    "shogun",
+    "swap",
+    "sdk",
+    "api",
+    "typescript"
+  ],
+  "devDependencies": {
+    "@types/node": "22.13.10",
+    "typescript": "5.8.2"
+  },
+  "dependencies": {
+    "@mysten/sui": "^1.29.1",
+    "@solana-program/system": "^0.7.0",
+    "@solana-program/token": "^0.5.1",
+    "@solana/kit": "^2.1.0",
+    "viem": "^2.26.2"
+  },
+  "scripts": {
+    "build": "pnpm clean && pnpm build:esm && pnpm build:types",
+    "build:esm": "tsc --project ./tsconfig.build.json --module es2015 --outDir ./dist/_esm && printf '{\"type\": \"module\",\"sideEffects\":false}' > ./dist/_esm/package.json",
+    "build:types": "tsc --project ./tsconfig.build.json --module esnext --declarationDir ./dist/_types --emitDeclarationOnly --declaration --declarationMap",
+    "clean": "rm -rf ./dist",
+    "check:types": "tsc --noEmit",
+    "lint": "npx eslint --fix --ext .ts ./src",
+    "format": "prettier --write ./src",
+    "pre-publish": "pnpm node ./scripts/prePublish.js"
+  }
+}

package/src/chains.ts

@@ -0,0 +1,77 @@
+import type { TupleToUnion } from './utils/type-utils.js';
+
+/**
+ * Represents the blockchain platform type
+ * Used to distinguish between different blockchain ecosystems
+ */
+export enum ChainType {
+  EVM = 'EVM',
+  Solana = 'Solana',
+  Sui = 'Sui',
+}
+
+/**
+ * Enum of chain IDs for supported blockchains
+ * EVM chains use their standard chain IDs
+ * Non-EVM chains use custom assigned IDs
+ */
+export enum ChainID {
+  Arbitrum = 42161,
+  Optimism = 10,
+  Base = 8453,
+  Solana = 7565164,
+  Sui = 101,
+}
+
+/**
+ * Array of chain IDs that are supported by the SDK
+ * Used as a source of truth for type generation
+ */
+export const SupportedChains = [ChainID.Arbitrum, ChainID.Base, ChainID.Optimism, ChainID.Solana, ChainID.Sui] as const;
+
+/**
+ * Type utility to identify chains not in the SupportedChains array
+ * @internal
+ */
+type UnsupportedChain = Exclude<ChainID, TupleToUnion<typeof SupportedChains>>;
+
+/**
+ * Type representing chains that are supported by the SDK
+ * Derived from the SupportedChains array
+ */
+export type SupportedChain = Exclude<ChainID, UnsupportedChain>;
+
+/**
+ * Type representing EVM chains that are supported by the SDK
+ * Includes Arbitrum, Base, and Optimism
+ */
+export type SupportedEvmChain = Exclude<ChainID, TupleToUnion<[ChainID.Solana, ChainID.Sui]>>;
+
+/**
+ * Type alias for Solana chain ID
+ */
+export type SupportedSolanaChain = ChainID.Solana;
+
+/**
+ * Type alias for Sui chain ID
+ */
+export type SupportedSuiChain = ChainID.Sui;
+
+/**
+ * Type guard that checks if a chain ID is among the supported chains
+ * @param chain - The chain ID to check
+ * @returns Boolean indicating if the chain is supported
+ */
+export const isSupportedChain = (chain: unknown): chain is SupportedChain => SupportedChains.includes(chain as number);
+
+/**
+ * Maps chain IDs to their corresponding chain types
+ * Used to determine which SDK implementation to use for a given chain
+ */
+export const chainIdToChainTypeMap = {
+  [ChainID.Arbitrum]: ChainType.EVM,
+  [ChainID.Base]: ChainType.EVM,
+  [ChainID.Optimism]: ChainType.EVM,
+  [ChainID.Solana]: ChainType.Solana,
+  [ChainID.Sui]: ChainType.Sui,
+} as const;

package/src/config.ts

@@ -0,0 +1,24 @@
+import type { SupportedEvmChain } from './chains.js';
+
+export type EVMConfig = {
+  chainId: SupportedEvmChain;
+  rpcProviderUrl?: string;
+  privateKey: `0x${string}`;
+};
+
+export type SolanaConfig = {
+  rpcProviderUrl?: string;
+  privateKey: string;
+  /**
+   * Transaction confirmation level
+   * - 'confirmed': Transaction has been processed and confirmed by the cluster
+   * - 'finalized': Transaction has been finalized and cannot be rolled back
+   */
+  commitment: 'confirmed' | 'finalized';
+};
+
+export type SuiConfig = {
+  privateKey: string;
+};
+
+export type SDKConfigParams = EVMConfig | SolanaConfig | SuiConfig;

package/src/constants.ts

@@ -0,0 +1,61 @@
+import { address, type Address as SolanaAddress } from '@solana/kit';
+import type { Address, Hex } from 'viem';
+import type { SupportedChain, SupportedEvmChain } from './chains.js';
+import { ChainID } from './chains.js';
+
+export const PERMIT2_ADDRESS: Record<SupportedEvmChain, Address> = {
+  [ChainID.Arbitrum]: '0x000000000022d473030f116ddee9f6b43ac78ba3' as Address,
+  [ChainID.Optimism]: '0x000000000022d473030f116ddee9f6b43ac78ba3' as Address,
+  [ChainID.Base]: '0x000000000022d473030f116ddee9f6b43ac78ba3' as Address,
+};
+
+// export const SRC_CHAIN_GUARD: Record<SupportedChain, SolanaAddress | Hex> = {
+//   [ChainID.Arbitrum]: '0x921ab91ee3dc38fd47aefd6218fd6b0bd9d64c18' as Address,
+//   [ChainID.Optimism]: '0xa89b2aae94769bf4a5dc9982eabe2c513564d1ea' as Address,
+//   [ChainID.Base]: '0x5173e9f12e2485f990ce4dac877d8545fb4ec81a' as Address,
+//   [ChainID.Solana]: address('4kD6otCKkKZQej8YNQkWdzG9xMo5XYN8T1BbUrJUE63E'),
+//   [ChainID.Sui]:
+//     '0x88a47715f41c5e47ff6d6dcfc0285f3802ae1587a9f411d0daff20269245a1b0',
+// }
+
+export const SRC_CHAIN_GUARD: Record<SupportedChain, SolanaAddress | Hex> = {
+  [ChainID.Arbitrum]: '0x8cfacbe4e236c0ca0a7b4b9fc5b696aa9f07cc41' as Address,
+  [ChainID.Optimism]: '0x66fbcccbd3ffe2d347bc2776ef8a6561ff29998e' as Address,
+  [ChainID.Base]: '0xa895a53634854756ae8e902065e3be26ee36381d' as Address,
+  [ChainID.Solana]: address('FAKnXTY7cNz9wMTpH1wwsU9a1xzBAiMwAn2NXmGMLynP'),
+  [ChainID.Sui]: '0xd5057237ba5fe3d9aa00bb2a1555c3d3de77fd5653e72ce70f4aa0561fa9f04d',
+};
+
+// export const SRC_CHAIN_GUARD_TEST: Record<SupportedChain, SolanaAddress | Hex> =
+//   {
+//     [ChainID.Arbitrum]: '0x8cfacbe4e236c0ca0a7b4b9fc5b696aa9f07cc41' as Address,
+//     [ChainID.Optimism]: '0x66fbcccbd3ffe2d347bc2776ef8a6561ff29998e' as Address,
+//     [ChainID.Base]: '0xa895a53634854756ae8e902065e3be26ee36381d' as Address,
+//     [ChainID.Solana]: address('FAKnXTY7cNz9wMTpH1wwsU9a1xzBAiMwAn2NXmGMLynP'),
+//     [ChainID.Sui]:
+//       '0xd5057237ba5fe3d9aa00bb2a1555c3d3de77fd5653e72ce70f4aa0561fa9f04d',
+//   }
+
+export const NATIVE_SOLANA_TOKEN_ADDRESS = address('So11111111111111111111111111111111111111111');
+
+export const WRAPPED_SOL_MINT_ADDRESS = address('So11111111111111111111111111111111111111112');
+
+export const SUI_PACKAGE_ID = '0x6273e29f803ff5851f89ec17d40d5b1f367476e1677ad0a52ca408f64c4473fe';
+
+// export const TEST_SUI_PACKAGE_ID = '0x6273e29f803ff5851f89ec17d40d5b1f367476e1677ad0a52ca408f64c4473fe'
+
+export const SUI_GUARD_COLLATERAL_TYPE =
+  '0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC';
+
+export const SUI_GUARD_STABLECOIN_TYPE =
+  '0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC';
+
+/**
+ * URL of the auctioneer service endpoint
+ */
+// export const AUCTIONEER_URL = 'https://auctioneer-825534211396.us-central1.run.app'
+export const AUCTIONEER_URL = 'http://127.0.0.1:8080';
+
+export const MAX_UINT_64 = 2n ** 64n - 1n;
+export const MAX_UINT_128 = 2n ** 128n - 1n;
+export const MAX_UINT_256 = 2n ** 256n - 1n;