@mayanfinance/blink-sdk 0.1.8

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+Copyright (c) 2026 Mayan Finance
+
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE
+OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,15 @@
+# Blink SDK
+
+A package for creating and tracking Blink orders.
+
+```
+npm install @mayanfinance/blink-sdk
+```
+
+```ts
+import { createBlinkClient } from "@mayanfinance/blink-sdk";
+
+const { blink } = createBlinkClient({ apiKey: process.env.BLINK_API_KEY });
+```
+
+The client talks to `https://api.hular.dev` unless `baseUrl` is passed. Full documentation is at https://docs.hular.dev.

package/dist/amount.d.ts

@@ -0,0 +1,4 @@
+export declare const parseAmount: (value: string, decimals: number) => bigint;
+export declare const formatAmount: (raw: string | bigint, decimals?: number) => string;
+export declare const trimAmount: (value: string, digits: number) => string;
+export declare const formatUsdMicros: (micros: string) => string;

package/dist/amount.js

@@ -0,0 +1,32 @@
+export const parseAmount = (value, decimals) => {
+    const [whole, fraction = ""] = value.trim().split(".");
+    const padded = fraction.slice(0, decimals).padEnd(decimals, "0");
+    return BigInt(`${whole === "" ? "0" : whole}${padded}`);
+};
+export const formatAmount = (raw, decimals) => {
+    const value = raw.toString();
+    if (decimals === undefined) {
+        return value;
+    }
+    const negative = value.startsWith("-");
+    const digits = (negative ? value.slice(1) : value).padStart(decimals + 1, "0");
+    const whole = digits.slice(0, digits.length - decimals);
+    const fraction = digits.slice(digits.length - decimals).replace(/0+$/, "");
+    return `${negative ? "-" : ""}${whole}${fraction ? `.${fraction}` : ""}`;
+};
+export const trimAmount = (value, digits) => {
+    const [whole, fraction] = value.split(".");
+    if (!fraction) {
+        return whole;
+    }
+    const cut = fraction.slice(0, digits).replace(/0+$/, "");
+    return cut ? `${whole}.${cut}` : whole;
+};
+export const formatUsdMicros = (micros) => {
+    const value = Number(micros) / 1_000_000;
+    return value.toLocaleString(undefined, {
+        style: "currency",
+        currency: "USD",
+        maximumFractionDigits: value < 1 ? 4 : 2,
+    });
+};

package/dist/client.d.ts

@@ -0,0 +1,17 @@
+import { type Client } from "@connectrpc/connect";
+import { BlinkApi } from "./gen/blink/v1/api_pb.js";
+import { AdminApi } from "./gen/blink/v1/admin_pb.js";
+import { PartnerApi } from "./gen/blink/v1/partner_pb.js";
+export declare const BLINK_API_URL = "https://api.hular.dev";
+export interface BlinkClientOptions {
+    baseUrl?: string;
+    apiKey?: string;
+    token?: () => string | null;
+    telemetry?: boolean;
+}
+export interface BlinkClient {
+    blink: Client<typeof BlinkApi>;
+    partner: Client<typeof PartnerApi>;
+    admin: Client<typeof AdminApi>;
+}
+export declare const createBlinkClient: ({ baseUrl, apiKey, token, telemetry, }: BlinkClientOptions) => BlinkClient;

package/dist/client.js

@@ -0,0 +1,32 @@
+import { createClient } from "@connectrpc/connect";
+import { createGrpcWebTransport } from "@connectrpc/connect-web";
+import { BlinkApi } from "./gen/blink/v1/api_pb.js";
+import { AdminApi } from "./gen/blink/v1/admin_pb.js";
+import { PartnerApi } from "./gen/blink/v1/partner_pb.js";
+import { SDK_VERSION } from "./version.js";
+export const BLINK_API_URL = "https://api.hular.dev";
+export const createBlinkClient = ({ baseUrl = BLINK_API_URL, apiKey, token, telemetry = true, }) => {
+    const headers = (next) => (req) => {
+        if (apiKey) {
+            req.header.set("x-api-key", apiKey);
+        }
+        const session = token?.();
+        if (session) {
+            req.header.set("authorization", `Bearer ${session}`);
+        }
+        if (telemetry) {
+            req.header.set("x-blink-sdk-version", SDK_VERSION);
+            req.header.set("x-blink-sdk-platform", typeof window === "undefined" ? "node" : "browser");
+        }
+        return next(req);
+    };
+    const transport = createGrpcWebTransport({
+        baseUrl,
+        interceptors: [headers],
+    });
+    return {
+        blink: createClient(BlinkApi, transport),
+        partner: createClient(PartnerApi, transport),
+        admin: createClient(AdminApi, transport),
+    };
+};

package/dist/deposit.d.ts

@@ -0,0 +1,64 @@
+import type { BlinkClient } from "./client.js";
+import type { ChainStatus, OrderParams } from "./gen/blink/v1/api_pb.js";
+import { type ConnectedWallet, type WalletKind } from "./wallets.js";
+export interface DepositStep {
+    kind: "approve" | "deposit";
+    fee?: bigint;
+    run: () => Promise<string>;
+}
+export interface GaslessQuote {
+    sponsorAddress?: string;
+    sponsorGasBudget?: bigint;
+    depositDeadline?: string;
+}
+export interface DepositOptions {
+    directTransfer?: boolean;
+    depositDeadline?: string;
+}
+export interface ChainAdapter {
+    readonly kind: WalletKind;
+    balance(owner: string, token: string): Promise<bigint>;
+    canPayGas(owner: string): Promise<boolean>;
+    steps(wallet: ConnectedWallet, quoteHash: string, params: OrderParams, options?: DepositOptions): Promise<DepositStep[]>;
+    gaslessSteps(wallet: ConnectedWallet, quoteHash: string, params: OrderParams, quote: GaslessQuote): Promise<DepositStep[]>;
+}
+export declare class InsufficientGasError extends Error {
+    readonly required: bigint;
+    readonly balance: bigint;
+    constructor(symbol: string, decimals: number, required: bigint, balance: bigint);
+}
+export declare class EvmChainAdapter implements ChainAdapter {
+    private client;
+    private chain;
+    private chainId;
+    readonly kind = "evm";
+    constructor(client: BlinkClient, chain: ChainStatus, chainId: bigint);
+    balance(owner: string, token: string): Promise<bigint>;
+    canPayGas(owner: string): Promise<boolean>;
+    private gasWithAllowance;
+    private assertCanPay;
+    steps(wallet: ConnectedWallet, quoteHash: string, params: OrderParams, options?: DepositOptions): Promise<DepositStep[]>;
+    gaslessSteps(wallet: ConnectedWallet, quoteHash: string, params: OrderParams, quote: GaslessQuote): Promise<DepositStep[]>;
+}
+export declare class SvmChainAdapter implements ChainAdapter {
+    private chain;
+    private client?;
+    readonly kind = "svm";
+    constructor(chain: ChainStatus, client?: BlinkClient | undefined);
+    balance(owner: string, token: string): Promise<bigint>;
+    canPayGas(owner: string): Promise<boolean>;
+    steps(wallet: ConnectedWallet, quoteHash: string, params: OrderParams, options?: DepositOptions): Promise<DepositStep[]>;
+    gaslessSteps(wallet: ConnectedWallet, quoteHash: string, params: OrderParams, quote: GaslessQuote): Promise<DepositStep[]>;
+}
+export declare class SuiChainAdapter implements ChainAdapter {
+    private chain;
+    private client?;
+    readonly kind = "sui";
+    constructor(chain: ChainStatus, client?: BlinkClient | undefined);
+    balance(owner: string, token: string): Promise<bigint>;
+    canPayGas(owner: string): Promise<boolean>;
+    steps(wallet: ConnectedWallet, quoteHash: string, params: OrderParams, options?: DepositOptions): Promise<DepositStep[]>;
+    gaslessSteps(wallet: ConnectedWallet, quoteHash: string, params: OrderParams, quote: GaslessQuote): Promise<DepositStep[]>;
+}
+export declare const createChainAdapter: (client: BlinkClient, chain: ChainStatus, chainId?: bigint) => ChainAdapter;
+export declare const walletKindOf: (chain?: ChainStatus) => WalletKind;