@upcoming/multichain-library 0.1.0

package/dist/Constants.d.ts

@@ -0,0 +1,8 @@
+import { FixedPointNumber } from 'cafe-utility';
+export declare const Constants: {
+    nullAddress: `0x${string}`;
+    bzzGnosisAddress: `0x${string}`;
+    ethereumChainId: number;
+    gnosisChainId: number;
+    daiDustAmount: FixedPointNumber;
+};

package/dist/Constants.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Constants = void 0;
+const cafe_utility_1 = require("cafe-utility");
+exports.Constants = {
+    nullAddress: '0x0000000000000000000000000000000000000000',
+    bzzGnosisAddress: '0xdbf3ea6f5bee45c02255b2c26a16f300502f68da',
+    ethereumChainId: 1,
+    gnosisChainId: 100,
+    daiDustAmount: cafe_utility_1.FixedPointNumber.fromDecimalString('0.01', 18)
+};

package/dist/GnosisBzzBalance.d.ts

@@ -0,0 +1,3 @@
+import { FixedPointNumber } from 'cafe-utility';
+import { MultichainLibrarySettings } from './Settings';
+export declare function getGnosisBzzBalance(address: string, settings: MultichainLibrarySettings): Promise<FixedPointNumber>;

package/dist/GnosisBzzBalance.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGnosisBzzBalance = getGnosisBzzBalance;
+const cafe_utility_1 = require("cafe-utility");
+const Constants_1 = require("./Constants");
+async function getGnosisBzzBalance(address, settings) {
+    address = address.toLowerCase();
+    if (address.startsWith('0x')) {
+        address = address.slice(2);
+    }
+    const payload = {
+        jsonrpc: '2.0',
+        id: 1,
+        method: 'eth_call',
+        params: [
+            {
+                from: Constants_1.Constants.nullAddress,
+                data: `0x70a08231000000000000000000000000${address}`,
+                to: Constants_1.Constants.bzzGnosisAddress
+            },
+            'latest'
+        ]
+    };
+    const response = await fetch(settings.gnosisJsonRpc, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(payload),
+        signal: AbortSignal.timeout(settings.fetchTimeoutMillis)
+    });
+    const data = await response.json();
+    const object = cafe_utility_1.Types.asObject(data);
+    const balance = cafe_utility_1.Types.asHexString(object.result, { strictPrefix: true, uneven: true });
+    return new cafe_utility_1.FixedPointNumber(BigInt(balance), 16);
+}

package/dist/GnosisNativeBalance.d.ts

@@ -0,0 +1,3 @@
+import { FixedPointNumber } from 'cafe-utility';
+import { MultichainLibrarySettings } from './Settings';
+export declare function getGnosisNativeBalance(address: `0x${string}`, settings: MultichainLibrarySettings): Promise<FixedPointNumber>;

package/dist/GnosisNativeBalance.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGnosisNativeBalance = getGnosisNativeBalance;
+const cafe_utility_1 = require("cafe-utility");
+async function getGnosisNativeBalance(address, settings) {
+    const payload = { jsonrpc: '2.0', id: 1, method: 'eth_getBalance', params: [address, 'latest'] };
+    const response = await fetch(settings.gnosisJsonRpc, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(payload),
+        signal: AbortSignal.timeout(settings.fetchTimeoutMillis)
+    });
+    const data = await response.json();
+    const object = cafe_utility_1.Types.asObject(data);
+    const price = cafe_utility_1.Types.asHexString(object.result, { strictPrefix: true, uneven: true });
+    return new cafe_utility_1.FixedPointNumber(BigInt(price), 18);
+}

package/dist/GnosisNativeTransfer.d.ts

@@ -0,0 +1,8 @@
+import { MultichainLibrarySettings } from './Settings';
+export interface TransferGnosisNativeOptions {
+    amount: string | bigint;
+    originPrivateKey: `0x${string}`;
+    originAddress: `0x${string}`;
+    to: `0x${string}`;
+}
+export declare function transferGnosisNative(options: TransferGnosisNativeOptions, settings: MultichainLibrarySettings): Promise<`0x${string}`>;

package/dist/GnosisNativeTransfer.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transferGnosisNative = transferGnosisNative;
+const cafe_utility_1 = require("cafe-utility");
+const viem_1 = require("viem");
+const accounts_1 = require("viem/accounts");
+const chains_1 = require("viem/chains");
+const Constants_1 = require("./Constants");
+const GnosisTransactionCount_1 = require("./GnosisTransactionCount");
+async function transferGnosisNative(options, settings) {
+    const account = (0, accounts_1.privateKeyToAccount)(options.originPrivateKey);
+    const client = (0, viem_1.createWalletClient)({
+        chain: chains_1.gnosis,
+        transport: (0, viem_1.http)(settings.gnosisJsonRpc)
+    });
+    return account
+        .signTransaction({
+        chain: Constants_1.Constants.gnosisChainId,
+        chainId: Constants_1.Constants.gnosisChainId,
+        account: options.originAddress,
+        gas: BigInt(21000),
+        gasPrice: BigInt(cafe_utility_1.Numbers.make('1 gwei')),
+        type: 'legacy',
+        to: options.to,
+        value: BigInt(options.amount),
+        nonce: await (0, GnosisTransactionCount_1.getGnosisTransactionCount)(options.originAddress, settings)
+    })
+        .then(signedTx => client.sendRawTransaction({ serializedTransaction: signedTx }));
+}

package/dist/GnosisSwap.d.ts

@@ -0,0 +1,18 @@
+import { MultichainLibrarySettings } from './Settings';
+export interface GnosisSwapAutoOptions {
+    amount: string | bigint;
+    originPrivateKey: `0x${string}`;
+    originAddress: `0x${string}`;
+    to: `0x${string}`;
+}
+export declare function swapOnGnosisAuto(options: GnosisSwapAutoOptions, settings: MultichainLibrarySettings): Promise<`0x${string}`>;
+export interface GnosisSwapCustomOptions {
+    originPrivateKey: `0x${string}`;
+    originAddress: `0x${string}`;
+    gas: bigint | string | number;
+    gasPrice: bigint | string | number;
+    to: `0x${string}`;
+    value: bigint | string | number;
+    data: `0x${string}`;
+}
+export declare function swapOnGnosisCustom(options: GnosisSwapCustomOptions, settings: MultichainLibrarySettings): Promise<`0x${string}`>;

package/dist/GnosisSwap.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.swapOnGnosisAuto = swapOnGnosisAuto;
+exports.swapOnGnosisCustom = swapOnGnosisCustom;
+const viem_1 = require("viem");
+const accounts_1 = require("viem/accounts");
+const chains_1 = require("viem/chains");
+const Constants_1 = require("./Constants");
+const GnosisTransactionCount_1 = require("./GnosisTransactionCount");
+const SushiSwap_1 = require("./SushiSwap");
+async function swapOnGnosisAuto(options, settings) {
+    const quote = await (0, SushiSwap_1.getSushiSwapQuote)(options.amount.toString(), options.originAddress, options.to, settings);
+    return swapOnGnosisCustom({
+        originPrivateKey: options.originPrivateKey,
+        originAddress: options.originAddress,
+        gas: BigInt(quote.tx.gas),
+        gasPrice: BigInt(quote.tx.gasPrice),
+        to: quote.tx.to,
+        value: BigInt(quote.tx.value),
+        data: quote.tx.data
+    }, settings);
+}
+async function swapOnGnosisCustom(options, settings) {
+    const account = (0, accounts_1.privateKeyToAccount)(options.originPrivateKey);
+    const client = (0, viem_1.createWalletClient)({ chain: chains_1.gnosis, transport: (0, viem_1.http)(settings.gnosisJsonRpc) });
+    return account
+        .signTransaction({
+        chain: Constants_1.Constants.gnosisChainId,
+        chainId: Constants_1.Constants.gnosisChainId,
+        account: options.originAddress,
+        gas: BigInt(options.gas),
+        gasPrice: BigInt(options.gasPrice),
+        type: 'legacy',
+        to: options.to,
+        value: BigInt(options.value),
+        data: options.data,
+        nonce: await (0, GnosisTransactionCount_1.getGnosisTransactionCount)(options.originAddress, settings)
+    })
+        .then(signedTx => client.sendRawTransaction({ serializedTransaction: signedTx }));
+}

package/dist/GnosisTransactionCount.d.ts

@@ -0,0 +1,2 @@
+import { MultichainLibrarySettings } from './Settings';
+export declare function getGnosisTransactionCount(address: string, settings: MultichainLibrarySettings): Promise<number>;

package/dist/GnosisTransactionCount.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGnosisTransactionCount = getGnosisTransactionCount;
+const cafe_utility_1 = require("cafe-utility");
+async function getGnosisTransactionCount(address, settings) {
+    address = address.toLowerCase();
+    if (address.startsWith('0x')) {
+        address = address.slice(2);
+    }
+    const payload = {
+        jsonrpc: '2.0',
+        id: 1,
+        method: 'eth_getTransactionCount',
+        params: [`0x${address}`, 'latest']
+    };
+    const response = await fetch(settings.gnosisJsonRpc, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(payload),
+        signal: AbortSignal.timeout(settings.fetchTimeoutMillis)
+    });
+    const data = await response.json();
+    const object = cafe_utility_1.Types.asObject(data);
+    const count = cafe_utility_1.Types.asHexString(object.result, { strictPrefix: true, uneven: true });
+    return parseInt(count, 16);
+}

package/dist/Settings.d.ts

@@ -0,0 +1,8 @@
+export interface MultichainLibrarySettings {
+    gnosisJsonRpc: string;
+    fetchTimeoutMillis: number;
+}
+export declare function getDefaultMultichainLibrarySettings(): {
+    gnosisJsonRpc: string;
+    fetchTimeoutMillis: number;
+};

package/dist/Settings.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultMultichainLibrarySettings = getDefaultMultichainLibrarySettings;
+const cafe_utility_1 = require("cafe-utility");
+function getDefaultMultichainLibrarySettings() {
+    return {
+        gnosisJsonRpc: 'https://xdai.fairdatasociety.org/',
+        fetchTimeoutMillis: cafe_utility_1.Dates.seconds(10)
+    };
+}

package/dist/SushiSwap.d.ts

@@ -0,0 +1,29 @@
+import { MultichainLibrarySettings } from './Settings';
+interface SushiToken {
+    address: `0x${string}`;
+    symbol: string;
+    name: string;
+    decimals: number;
+}
+interface SushiTx {
+    from: `0x${string}`;
+    to: `0x${string}`;
+    gas: string;
+    gasPrice: number;
+    data: `0x${string}`;
+    value: string;
+}
+export interface SushiResponse {
+    status: 'Success' | string;
+    tokens: SushiToken[];
+    tokenFrom: number;
+    tokenTo: number;
+    swapPrice: number;
+    priceImpact: number;
+    amountIn: string;
+    assumedAmountOut: string;
+    gasSpent: number;
+    tx: SushiTx;
+}
+export declare function getSushiSwapQuote(amount: string, sender: string, recipient: string, settings: MultichainLibrarySettings): Promise<SushiResponse>;
+export {};

package/dist/SushiSwap.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSushiSwapQuote = getSushiSwapQuote;
+const Constants_1 = require("./Constants");
+async function getSushiSwapQuote(amount, sender, recipient, settings) {
+    const tokenIn = '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE'; // xDAI
+    const tokenOut = Constants_1.Constants.bzzGnosisAddress;
+    const response = await fetch(`https://api.sushi.com/swap/v7/100?tokenIn=${tokenIn}&tokenOut=${tokenOut}&amount=${amount}&maxSlippage=0.005&sender=${sender}&recipient=${recipient}&fee=0.0025&feeBy=output&feeReceiver=0xde7259893af7cdbc9fd806c6ba61d22d581d5667&simulate=true`, { signal: AbortSignal.timeout(settings.fetchTimeoutMillis) });
+    const data = await response.json();
+    return data;
+}

package/dist/TokenPrice.d.ts

@@ -0,0 +1,3 @@
+import { MultichainLibrarySettings } from './Settings';
+export declare function getTokenPrice(tokenAddress: `0x${string}`, chainId: number, settings: MultichainLibrarySettings): Promise<number>;
+export declare function getGnosisBzzTokenPrice(settings: MultichainLibrarySettings): Promise<number>;

package/dist/TokenPrice.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTokenPrice = getTokenPrice;
+exports.getGnosisBzzTokenPrice = getGnosisBzzTokenPrice;
+const Constants_1 = require("./Constants");
+async function getTokenPrice(tokenAddress, chainId, settings) {
+    const response = await fetch(`https://api.relay.link/currencies/token/price?address=${tokenAddress}&chainId=${chainId}`, { signal: AbortSignal.timeout(settings.fetchTimeoutMillis) });
+    const data = (await response.json());
+    return data.price;
+}
+async function getGnosisBzzTokenPrice(settings) {
+    return getTokenPrice(Constants_1.Constants.bzzGnosisAddress, Constants_1.Constants.gnosisChainId, settings);
+}

package/dist/Waiter.d.ts

@@ -0,0 +1,4 @@
+import { MultichainLibrarySettings } from './Settings';
+export declare function waitForGnosisBzzBalanceToIncrease(address: string, initialBalance: bigint, settings: MultichainLibrarySettings): Promise<void>;
+export declare function waitForGnosisNativeBalanceToDecrease(address: `0x${string}`, initialBalance: bigint, settings: MultichainLibrarySettings): Promise<void>;
+export declare function waitForGnosisNativeBalanceToIncrease(address: `0x${string}`, initialBalance: bigint, settings: MultichainLibrarySettings): Promise<void>;

package/dist/Waiter.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.waitForGnosisBzzBalanceToIncrease = waitForGnosisBzzBalanceToIncrease;
+exports.waitForGnosisNativeBalanceToDecrease = waitForGnosisNativeBalanceToDecrease;
+exports.waitForGnosisNativeBalanceToIncrease = waitForGnosisNativeBalanceToIncrease;
+const cafe_utility_1 = require("cafe-utility");
+const GnosisBzzBalance_1 = require("./GnosisBzzBalance");
+const GnosisNativeBalance_1 = require("./GnosisNativeBalance");
+async function waitForGnosisBzzBalanceToIncrease(address, initialBalance, settings) {
+    await cafe_utility_1.System.waitFor(async () => {
+        try {
+            const balance = await (0, GnosisBzzBalance_1.getGnosisBzzBalance)(address, settings);
+            return balance.value > initialBalance;
+        }
+        catch (error) {
+            console.error(`Error fetching ${address} wallet BZZ balance:`, error);
+            return false;
+        }
+    }, { attempts: 20, waitMillis: cafe_utility_1.Dates.seconds(15) });
+}
+async function waitForGnosisNativeBalanceToDecrease(address, initialBalance, settings) {
+    await cafe_utility_1.System.waitFor(async () => {
+        try {
+            const balance = await (0, GnosisNativeBalance_1.getGnosisNativeBalance)(address, settings);
+            return balance.value < initialBalance;
+        }
+        catch (error) {
+            console.error(`Error fetching ${address} wallet native balance:`, error);
+            return false;
+        }
+    }, { attempts: 20, waitMillis: cafe_utility_1.Dates.seconds(15) });
+}
+async function waitForGnosisNativeBalanceToIncrease(address, initialBalance, settings) {
+    await cafe_utility_1.System.waitFor(async () => {
+        try {
+            const balance = await (0, GnosisNativeBalance_1.getGnosisNativeBalance)(address, settings);
+            return balance.value > initialBalance;
+        }
+        catch (error) {
+            console.error(`Error fetching ${address} wallet native balance:`, error);
+            return false;
+        }
+    }, { attempts: 20, waitMillis: cafe_utility_1.Dates.seconds(15) });
+}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import { FixedPointNumber } from 'cafe-utility';
+import { TransferGnosisNativeOptions } from './GnosisNativeTransfer';
+import { GnosisSwapAutoOptions, GnosisSwapCustomOptions } from './GnosisSwap';
+import { MultichainLibrarySettings } from './Settings';
+import { SushiResponse } from './SushiSwap';
+export declare class MultichainLibrary {
+    settings: MultichainLibrarySettings;
+    constructor(settings?: Partial<MultichainLibrarySettings>);
+    getGnosisBzzBalance(address: string): Promise<FixedPointNumber>;
+    getGnosisNativeBalance(address: `0x${string}`): Promise<FixedPointNumber>;
+    getTokenPrice(tokenAddress: `0x${string}`, chainId: number): Promise<number>;
+    getGnosisBzzTokenPrice(): Promise<number>;
+    transferGnosisNative(options: TransferGnosisNativeOptions): Promise<`0x${string}`>;
+    waitForGnosisBzzBalanceToIncrease(address: string, initialBalance: bigint): Promise<void>;
+    waitForGnosisNativeBalanceToDecrease(address: `0x${string}`, initialBalance: bigint): Promise<void>;
+    waitForGnosisNativeBalanceToIncrease(address: `0x${string}`, initialBalance: bigint): Promise<void>;
+    swapOnGnosisAuto(options: GnosisSwapAutoOptions): Promise<`0x${string}`>;
+    swapOnGnosisCustom(options: GnosisSwapCustomOptions): Promise<`0x${string}`>;
+    getGnosisTransactionCount(address: `0x${string}`): Promise<number>;
+    getSushiSwapQuote(amount: string, sender: string, recipient: string): Promise<SushiResponse>;
+}
+export { MultichainLibrarySettings } from './Settings';
+export { SushiResponse } from './SushiSwap';

package/dist/index.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultichainLibrary = void 0;
+const cafe_utility_1 = require("cafe-utility");
+const GnosisBzzBalance_1 = require("./GnosisBzzBalance");
+const GnosisNativeBalance_1 = require("./GnosisNativeBalance");
+const GnosisNativeTransfer_1 = require("./GnosisNativeTransfer");
+const GnosisSwap_1 = require("./GnosisSwap");
+const GnosisTransactionCount_1 = require("./GnosisTransactionCount");
+const Settings_1 = require("./Settings");
+const SushiSwap_1 = require("./SushiSwap");
+const TokenPrice_1 = require("./TokenPrice");
+const Waiter_1 = require("./Waiter");
+class MultichainLibrary {
+    settings;
+    constructor(settings) {
+        this.settings = cafe_utility_1.Objects.deepMerge2((0, Settings_1.getDefaultMultichainLibrarySettings)(), settings || {});
+    }
+    getGnosisBzzBalance(address) {
+        return (0, GnosisBzzBalance_1.getGnosisBzzBalance)(address, this.settings);
+    }
+    getGnosisNativeBalance(address) {
+        return (0, GnosisNativeBalance_1.getGnosisNativeBalance)(address, this.settings);
+    }
+    getTokenPrice(tokenAddress, chainId) {
+        return (0, TokenPrice_1.getTokenPrice)(tokenAddress, chainId, this.settings);
+    }
+    getGnosisBzzTokenPrice() {
+        return (0, TokenPrice_1.getGnosisBzzTokenPrice)(this.settings);
+    }
+    transferGnosisNative(options) {
+        return (0, GnosisNativeTransfer_1.transferGnosisNative)(options, this.settings);
+    }
+    waitForGnosisBzzBalanceToIncrease(address, initialBalance) {
+        return (0, Waiter_1.waitForGnosisBzzBalanceToIncrease)(address, initialBalance, this.settings);
+    }
+    waitForGnosisNativeBalanceToDecrease(address, initialBalance) {
+        return (0, Waiter_1.waitForGnosisNativeBalanceToDecrease)(address, initialBalance, this.settings);
+    }
+    waitForGnosisNativeBalanceToIncrease(address, initialBalance) {
+        return (0, Waiter_1.waitForGnosisNativeBalanceToIncrease)(address, initialBalance, this.settings);
+    }
+    swapOnGnosisAuto(options) {
+        return (0, GnosisSwap_1.swapOnGnosisAuto)(options, this.settings);
+    }
+    swapOnGnosisCustom(options) {
+        return (0, GnosisSwap_1.swapOnGnosisCustom)(options, this.settings);
+    }
+    getGnosisTransactionCount(address) {
+        return (0, GnosisTransactionCount_1.getGnosisTransactionCount)(address, this.settings);
+    }
+    getSushiSwapQuote(amount, sender, recipient) {
+        return (0, SushiSwap_1.getSushiSwapQuote)(amount, sender, recipient, this.settings);
+    }
+}
+exports.MultichainLibrary = MultichainLibrary;

package/package.json

@@ -0,0 +1,28 @@
+{
+    "name": "@upcoming/multichain-library",
+    "private": false,
+    "version": "0.1.0",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "scripts": {
+        "build": "tsc"
+    },
+    "keywords": [],
+    "author": "",
+    "license": "ISC",
+    "description": "",
+    "dependencies": {
+        "cafe-utility": "^33.0.0",
+        "viem": "^2.38.2"
+    },
+    "devDependencies": {
+        "@types/node": "^24.7.2",
+        "typescript": "^5.9.3"
+    }
+}

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+    "$schema": "https://json.schemastore.org/tsconfig",
+    "display": "Node 16",
+
+    "compilerOptions": {
+        "outDir": "dist",
+        "lib": ["ES2022"],
+        "module": "CommonJS",
+        "target": "ES2022",
+        "declaration": true,
+        "strict": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "moduleResolution": "node",
+        "esModuleInterop": true,
+        "noImplicitAny": true,
+        "noUnusedLocals": true,
+        "strictNullChecks": true
+    }
+}