@across-protocol/sdk 4.3.155 → 4.4.0-alpha.10

package/dist/esm/src/svm/web3-v1/cctpV2Helpers.js

@@ -0,0 +1,173 @@
+import * as anchor from "@coral-xyz/anchor";
+import { array, enums, object, optional, string, union, nullable, coerce, assert } from "superstruct";
+import { ethers } from "ethers";
+import { readUInt256BE } from "./relayHashUtils";
+import { addressOrBase58ToBytes32 } from "./conversionUtils";
+// Index positions to decode Message Header from
+// https://developers.circle.com/cctp/technical-guide#message-header
+const HEADER_VERSION_INDEX = 0;
+const SOURCE_DOMAIN_INDEX = 4;
+const DESTINATION_DOMAIN_INDEX = 8;
+const NONCE_INDEX = 12;
+const HEADER_SENDER_INDEX = 44;
+const HEADER_RECIPIENT_INDEX = 76;
+const DESTINATION_CALLER_INDEX = 108;
+const MIN_FINALITY_THRESHOLD_INDEX = 140;
+const FINALITY_THRESHOLD_EXECUTED_INDEX = 144;
+const MESSAGE_BODY_INDEX = 148;
+// Index positions to decode Message Body for TokenMessengerV2 from
+// https://developers.circle.com/cctp/technical-guide#message-body
+const BODY_VERSION_INDEX = 0;
+const BURN_TOKEN_INDEX = 4;
+const MINT_RECIPIENT_INDEX = 36;
+const AMOUNT_INDEX = 68;
+const MESSAGE_SENDER_INDEX = 100;
+const MAX_FEE_INDEX = 132;
+const FEE_EXECUTED_INDEX = 164;
+const EXPIRATION_BLOCK = 196;
+const HOOK_DATA_INDEX = 228;
+export const EVENT_ACCOUNT_WINDOW_SECONDS = 60 * 60 * 24 * 5; // 60 secs * 60 mins * 24 hours * 5 days = 5 days in seconds
+/**
+ * Decodes a CCTPv2 message into a MessageHeaderV2 and TokenMessengerV2MessageBody.
+ */
+export const decodeMessageSentDataV2 = (message) => {
+    const messageHeader = decodeMessageHeaderV2(message);
+    const messageBodyData = message.slice(MESSAGE_BODY_INDEX);
+    const messageBody = decodeTokenMessengerV2MessageBody(messageBodyData);
+    return { ...messageHeader, messageBody };
+};
+/**
+ * Decodes a CCTPv2 message header.
+ */
+export const decodeMessageHeaderV2 = (data) => {
+    const version = data.readUInt32BE(HEADER_VERSION_INDEX);
+    const sourceDomain = data.readUInt32BE(SOURCE_DOMAIN_INDEX);
+    const destinationDomain = data.readUInt32BE(DESTINATION_DOMAIN_INDEX);
+    const nonce = readUInt256BE(data.slice(NONCE_INDEX, NONCE_INDEX + 32));
+    const sender = new anchor.web3.PublicKey(data.slice(HEADER_SENDER_INDEX, HEADER_SENDER_INDEX + 32));
+    const recipient = new anchor.web3.PublicKey(data.slice(HEADER_RECIPIENT_INDEX, HEADER_RECIPIENT_INDEX + 32));
+    const destinationCaller = new anchor.web3.PublicKey(data.slice(DESTINATION_CALLER_INDEX, DESTINATION_CALLER_INDEX + 32));
+    const minFinalityThreshold = data.readUInt32BE(MIN_FINALITY_THRESHOLD_INDEX);
+    const finalityThresholdExecuted = data.readUInt32BE(FINALITY_THRESHOLD_EXECUTED_INDEX);
+    const messageBody = data.slice(MESSAGE_BODY_INDEX);
+    return {
+        version,
+        sourceDomain,
+        destinationDomain,
+        nonce,
+        sender,
+        recipient,
+        destinationCaller,
+        minFinalityThreshold,
+        finalityThresholdExecuted,
+        messageBody,
+    };
+};
+/**
+ * Decodes a TokenMessenger message body.
+ */
+export const decodeTokenMessengerV2MessageBody = (data) => {
+    const version = data.readUInt32BE(BODY_VERSION_INDEX);
+    const burnToken = new anchor.web3.PublicKey(data.slice(BURN_TOKEN_INDEX, BURN_TOKEN_INDEX + 32));
+    const mintRecipient = new anchor.web3.PublicKey(data.slice(MINT_RECIPIENT_INDEX, MINT_RECIPIENT_INDEX + 32));
+    const amount = readUInt256BE(data.slice(AMOUNT_INDEX, AMOUNT_INDEX + 32));
+    const messageSender = new anchor.web3.PublicKey(data.slice(MESSAGE_SENDER_INDEX, MESSAGE_SENDER_INDEX + 32));
+    const maxFee = readUInt256BE(data.slice(MAX_FEE_INDEX, MAX_FEE_INDEX + 32));
+    const feeExecuted = readUInt256BE(data.slice(FEE_EXECUTED_INDEX, FEE_EXECUTED_INDEX + 32));
+    const expirationBlock = readUInt256BE(data.slice(EXPIRATION_BLOCK, EXPIRATION_BLOCK + 32));
+    const hookData = data.slice(HOOK_DATA_INDEX);
+    return { version, burnToken, mintRecipient, amount, messageSender, maxFee, feeExecuted, expirationBlock, hookData };
+};
+// Below structs defines the types for CCTP attestation API as documented in
+// https://developers.circle.com/api-reference/cctp/all/get-messages-v-2
+// DecodedMessage.decodedMessageBody (V1/V2; some fields V2-only)
+export const DecodedMessageBody = object({
+    burnToken: string(),
+    mintRecipient: string(),
+    amount: string(),
+    messageSender: string(),
+    // V2-only
+    maxFee: optional(string()),
+    feeExecuted: optional(string()),
+    expirationBlock: optional(string()),
+    hookData: optional(string()),
+});
+// DecodedMessage (nullable/empty if decoding fails)
+// minFinalityThreshold & finalityThresholdExecuted are V2-only
+export const DecodedMessage = object({
+    sourceDomain: string(),
+    destinationDomain: string(),
+    nonce: string(),
+    sender: string(),
+    recipient: string(),
+    destinationCaller: string(),
+    minFinalityThreshold: optional(enums(["1000", "2000"])),
+    finalityThresholdExecuted: optional(enums(["1000", "2000"])),
+    messageBody: string(),
+    decodedMessageBody: optional(coerce(nullable(DecodedMessageBody), union([nullable(DecodedMessageBody), object({})]), (v) => isEmptyObject(v) ? null : v)),
+});
+// Each message item
+export const AttestationMessage = object({
+    message: string(), // "0x" when not available
+    eventNonce: string(),
+    attestation: string(), // "PENDING" when not available
+    decodedMessage: optional(coerce(nullable(DecodedMessage), union([nullable(DecodedMessage), object({})]), (v) => isEmptyObject(v) ? null : v)),
+    cctpVersion: enums([1, 2]),
+    status: enums(["complete", "pending_confirmations"]),
+    // Only present in some delayed cases
+    delayReason: optional(nullable(enums(["insufficient_fee", "amount_above_max", "insufficient_allowance_available"]))),
+});
+// Top-level 200 response
+export const AttestationResponse = object({
+    messages: array(AttestationMessage),
+});
+const isEmptyObject = (v) => v != null && typeof v === "object" && !Array.isArray(v) && Object.keys(v).length === 0;
+/**
+ * Fetches attestation from attestation service given the txHash and source message for CCTP V2 token burn.
+ */
+export async function getV2BurnAttestation(txSignature, sourceMessageData, irisApiUrl) {
+    const sourceMessage = decodeMessageSentDataV2(sourceMessageData);
+    const attestationResponse = await (await fetch(`${irisApiUrl}/v2/messages/${sourceMessage.sourceDomain}/?transactionHash=${txSignature}`)).json();
+    if (attestationResponse.error)
+        return null;
+    assert(attestationResponse, AttestationResponse);
+    // Return the first attested message that matches the source message.
+    for (const message of attestationResponse.messages) {
+        if (message.message !== "0x" &&
+            message.attestation !== "PENDING" &&
+            !!message.decodedMessage &&
+            isMatchingV2BurnMessage(sourceMessage, message.decodedMessage)) {
+            return {
+                destinationMessage: Buffer.from(ethers.utils.arrayify(message.message)),
+                attestation: Buffer.from(ethers.utils.arrayify(message.attestation)),
+            };
+        }
+    }
+    return null;
+}
+function isMatchingV2BurnMessage(sourceMessage, destinationMessage) {
+    if (!destinationMessage.decodedMessageBody)
+        return false;
+    return (sourceMessage.sourceDomain.toString() === destinationMessage.sourceDomain &&
+        sourceMessage.destinationDomain.toString() === destinationMessage.destinationDomain &&
+        // nonce is only set on destination
+        addressOrBase58ToBytes32(sourceMessage.sender.toString()) === addressOrBase58ToBytes32(destinationMessage.sender) &&
+        addressOrBase58ToBytes32(sourceMessage.recipient.toString()) ===
+            addressOrBase58ToBytes32(destinationMessage.recipient) &&
+        addressOrBase58ToBytes32(sourceMessage.destinationCaller.toString()) ===
+            addressOrBase58ToBytes32(destinationMessage.destinationCaller) &&
+        sourceMessage.minFinalityThreshold.toString() === destinationMessage.minFinalityThreshold &&
+        // finalityThresholdExecuted is only set on destination
+        addressOrBase58ToBytes32(sourceMessage.messageBody.burnToken.toString()) ===
+            addressOrBase58ToBytes32(destinationMessage.decodedMessageBody.burnToken) &&
+        addressOrBase58ToBytes32(sourceMessage.messageBody.mintRecipient.toString()) ===
+            addressOrBase58ToBytes32(destinationMessage.decodedMessageBody.mintRecipient) &&
+        sourceMessage.messageBody.amount.toString() === destinationMessage.decodedMessageBody.amount &&
+        addressOrBase58ToBytes32(sourceMessage.messageBody.messageSender.toString()) ===
+            addressOrBase58ToBytes32(destinationMessage.decodedMessageBody.messageSender) &&
+        sourceMessage.messageBody.maxFee.toString() === destinationMessage.decodedMessageBody.maxFee &&
+        // feeExecuted is only set on destination
+        // expirationBlock is only set on destination
+        sourceMessage.messageBody.hookData.equals(Buffer.from(ethers.utils.arrayify(destinationMessage.decodedMessageBody.hookData || "0x"))));
+}
+//# sourceMappingURL=cctpV2Helpers.js.map

package/dist/esm/src/svm/web3-v1/cctpV2Helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cctpV2Helpers.js","sourceRoot":"","sources":["../../../../../src/svm/web3-v1/cctpV2Helpers.ts"],"names":[],"mappings":"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"}

package/dist/esm/src/svm/web3-v1/coders.d.ts

@@ -0,0 +1,37 @@
+import { BorshAccountsCoder } from "@coral-xyz/anchor";
+import { Message, PublicKey, TransactionInstruction } from "@solana/web3.js";
+import { AcrossPlusMessage } from "../types.svm";
+/**
+ * Extended Anchor accounts coder to handle large account data.
+ */
+export declare class LargeAccountsCoder<A extends string = string> extends BorshAccountsCoder<A> {
+    private getAccountLayouts;
+    encode<T = any>(accountName: A, account: T): Promise<Buffer>;
+}
+/**
+ * Helper to encode MulticallHandler transactions.
+ */
+export declare class MulticallHandlerCoder {
+    readonly compiledMessage: Message;
+    private readonly layout;
+    constructor(instructions: TransactionInstruction[], payerKey?: PublicKey);
+    private static coderArg;
+    private static coderTypes;
+    get readOnlyLen(): number;
+    get compiledKeyMetas(): {
+        pubkey: PublicKey;
+        isSigner: boolean;
+        isWritable: boolean;
+    }[];
+    encode(): Buffer<ArrayBuffer>;
+}
+/**
+ * Helper to encode Across+ messages.
+ */
+export declare class AcrossPlusMessageCoder {
+    private acrossPlusMessage;
+    constructor(acrossPlusMessage: AcrossPlusMessage);
+    private static coderArg;
+    private static coderTypes;
+    encode(): Buffer<ArrayBuffer>;
+}

package/dist/esm/src/svm/web3-v1/coders.js

@@ -0,0 +1,227 @@
+import { BorshAccountsCoder } from "@coral-xyz/anchor";
+import { IdlCoder } from "@coral-xyz/anchor/dist/cjs/coder/borsh/idl";
+import * as borsh from "@coral-xyz/borsh";
+import { Message, MessageAccountKeys, PublicKey, } from "@solana/web3.js";
+import bs58 from "bs58";
+/**
+ * Extended Anchor accounts coder to handle large account data.
+ */
+export class LargeAccountsCoder extends BorshAccountsCoder {
+    // Getter to access the private accountLayouts property from base class.
+    getAccountLayouts() {
+        // Base class has `Map<A, { discriminator: IdlDiscriminator; layout: Layout }`, but we only use layout here.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        return this.accountLayouts;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any, require-await
+    async encode(accountName, account) {
+        const buffer = Buffer.alloc(10240); // We don't currently need anything above instruction data account reallocation limit.
+        const layout = this.getAccountLayouts().get(accountName);
+        if (!layout) {
+            throw new Error(`Unknown account: ${accountName}`);
+        }
+        const len = layout.layout.encode(account, buffer);
+        const accountData = buffer.slice(0, len);
+        const discriminator = this.accountDiscriminator(accountName);
+        return Buffer.concat([discriminator, accountData]);
+    }
+}
+/**
+ * Extended version of legacy CompiledKeys to handle compilation of unsigned transactions. Base implementation is here:
+ * https://github.com/solana-labs/solana-web3.js/blob/v1.95.3/src/message/compiled-keys.ts
+ */
+class UnsignedCompiledKeys {
+    keyModeMap;
+    payer;
+    constructor(keyModeMap, payer) {
+        this.keyModeMap = keyModeMap;
+        this.payer = payer;
+    }
+    static compileUnsigned(instructions, payer) {
+        const keyModeMap = new Map();
+        const getOrInsertDefault = (pubkey) => {
+            const address = pubkey.toBase58();
+            let keyMode = keyModeMap.get(address);
+            if (keyMode === undefined) {
+                keyMode = {
+                    isWritable: false,
+                };
+                keyModeMap.set(address, keyMode);
+            }
+            return keyMode;
+        };
+        if (payer !== undefined) {
+            const payerKeyMode = getOrInsertDefault(payer);
+            payerKeyMode.isWritable = true;
+        }
+        for (const ix of instructions) {
+            getOrInsertDefault(ix.programId);
+            for (const accountMeta of ix.keys) {
+                const keyMode = getOrInsertDefault(accountMeta.pubkey);
+                keyMode.isWritable ||= accountMeta.isWritable;
+            }
+        }
+        return new UnsignedCompiledKeys(keyModeMap, payer);
+    }
+    getMessageComponents() {
+        const mapEntries = Array.from(this.keyModeMap.entries());
+        if (mapEntries.length > 256)
+            throw new Error("Max static account keys length exceeded");
+        const writableNonSigners = mapEntries.filter(([, mode]) => mode.isWritable);
+        const readonlyNonSigners = mapEntries.filter(([, mode]) => !mode.isWritable);
+        const header = {
+            numRequiredSignatures: 0,
+            numReadonlySignedAccounts: 0,
+            numReadonlyUnsignedAccounts: readonlyNonSigners.length,
+        };
+        const staticAccountKeys = [
+            ...writableNonSigners.map(([address]) => new PublicKey(address)),
+            ...readonlyNonSigners.map(([address]) => new PublicKey(address)),
+        ];
+        return [header, staticAccountKeys];
+    }
+}
+/**
+ * Extended version of legacy Message to handle compilation of unsigned transactions. Base implementation is here:
+ * https://github.com/solana-labs/solana-web3.js/blob/v1.95.3/src/message/legacy.ts
+ */
+class UnsignedMessage extends Message {
+    static compileUnsigned(instructions, payer) {
+        const compiledKeys = UnsignedCompiledKeys.compileUnsigned(instructions, payer);
+        const [header, staticAccountKeys] = compiledKeys.getMessageComponents();
+        const accountKeys = new MessageAccountKeys(staticAccountKeys);
+        const compiledInstructions = accountKeys.compileInstructions(instructions).map((ix) => ({
+            programIdIndex: ix.programIdIndex,
+            accounts: ix.accountKeyIndexes,
+            data: bs58.encode(ix.data),
+        }));
+        return new Message({
+            header,
+            accountKeys: staticAccountKeys,
+            recentBlockhash: "", // Not used as we are not signing the transaction.
+            instructions: compiledInstructions,
+        });
+    }
+}
+/**
+ * Helper to encode MulticallHandler transactions.
+ */
+export class MulticallHandlerCoder {
+    compiledMessage;
+    layout;
+    constructor(instructions, payerKey) {
+        // Compile transaction message and keys.
+        this.compiledMessage = UnsignedMessage.compileUnsigned(instructions, payerKey);
+        // Setup the layout for the encoder.
+        const fieldLayouts = [IdlCoder.fieldLayout(MulticallHandlerCoder.coderArg, MulticallHandlerCoder.coderTypes)];
+        this.layout = borsh.struct(fieldLayouts);
+    }
+    static coderArg = {
+        name: "compiledIxs",
+        type: {
+            vec: {
+                defined: {
+                    name: "compiledIx",
+                },
+            },
+        },
+    };
+    static coderTypes = [
+        {
+            name: "compiledIx",
+            type: {
+                kind: "struct",
+                fields: [
+                    {
+                        name: "programIdIndex",
+                        type: "u8",
+                    },
+                    {
+                        name: "accountKeyIndexes",
+                        type: {
+                            vec: "u8",
+                        },
+                    },
+                    {
+                        name: "data",
+                        type: "bytes",
+                    },
+                ],
+            },
+        },
+    ];
+    get readOnlyLen() {
+        return (this.compiledMessage.header.numReadonlySignedAccounts + this.compiledMessage.header.numReadonlyUnsignedAccounts);
+    }
+    get compiledKeyMetas() {
+        return this.compiledMessage.accountKeys.map((key, index) => {
+            return {
+                pubkey: key,
+                isSigner: this.compiledMessage.isAccountSigner(index),
+                isWritable: this.compiledMessage.isAccountWritable(index),
+            };
+        });
+    }
+    encode() {
+        const buffer = Buffer.alloc(1280);
+        const len = this.layout.encode({ compiledIxs: this.compiledMessage.compiledInstructions }, buffer);
+        return buffer.slice(0, len);
+    }
+}
+/**
+ * Helper to encode Across+ messages.
+ */
+export class AcrossPlusMessageCoder {
+    acrossPlusMessage;
+    constructor(acrossPlusMessage) {
+        this.acrossPlusMessage = acrossPlusMessage;
+    }
+    static coderArg = {
+        name: "message",
+        type: {
+            defined: {
+                name: "acrossPlusMessage",
+            },
+        },
+    };
+    static coderTypes = [
+        {
+            name: "acrossPlusMessage",
+            type: {
+                kind: "struct",
+                fields: [
+                    {
+                        name: "handler",
+                        type: "pubkey",
+                    },
+                    {
+                        name: "readOnlyLen",
+                        type: "u8",
+                    },
+                    {
+                        name: "valueAmount",
+                        type: "u64",
+                    },
+                    {
+                        name: "accounts",
+                        type: {
+                            vec: "pubkey",
+                        },
+                    },
+                    {
+                        name: "handlerMessage",
+                        type: "bytes",
+                    },
+                ],
+            },
+        },
+    ];
+    encode() {
+        const fieldLayouts = [IdlCoder.fieldLayout(AcrossPlusMessageCoder.coderArg, AcrossPlusMessageCoder.coderTypes)];
+        const layout = borsh.struct(fieldLayouts);
+        const buffer = Buffer.alloc(12800);
+        const len = layout.encode({ message: this.acrossPlusMessage }, buffer);
+        return buffer.slice(0, len);
+    }
+}
+//# sourceMappingURL=coders.js.map

package/dist/esm/src/svm/web3-v1/coders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coders.js","sourceRoot":"","sources":["../../../../../src/svm/web3-v1/coders.ts"],"names":[],"mappings":"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"}

package/dist/esm/src/svm/web3-v1/constants.d.ts

@@ -0,0 +1,8 @@
+import BN from "bn.js";
+export declare const CIRCLE_IRIS_API_URL_DEVNET = "https://iris-api-sandbox.circle.com";
+export declare const CIRCLE_IRIS_API_URL_MAINNET = "https://iris-api.circle.com";
+export declare const SOLANA_USDC_MAINNET = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+export declare const SOLANA_USDC_DEVNET = "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU";
+export declare const SEPOLIA_CCTP_MESSAGE_TRANSMITTER_ADDRESS = "0x7865fAfC2db2093669d92c0F33AeEF291086BEFD";
+export declare const MAINNET_CCTP_MESSAGE_TRANSMITTER_ADDRESS = "0x0a992d191deec32afe36203ad87d7d289a738f81";
+export declare const SOLANA_SPOKE_STATE_SEED: BN;

package/dist/esm/src/svm/web3-v1/constants.js

@@ -0,0 +1,9 @@
+import BN from "bn.js";
+export const CIRCLE_IRIS_API_URL_DEVNET = "https://iris-api-sandbox.circle.com";
+export const CIRCLE_IRIS_API_URL_MAINNET = "https://iris-api.circle.com";
+export const SOLANA_USDC_MAINNET = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+export const SOLANA_USDC_DEVNET = "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU";
+export const SEPOLIA_CCTP_MESSAGE_TRANSMITTER_ADDRESS = "0x7865fAfC2db2093669d92c0F33AeEF291086BEFD";
+export const MAINNET_CCTP_MESSAGE_TRANSMITTER_ADDRESS = "0x0a992d191deec32afe36203ad87d7d289a738f81";
+export const SOLANA_SPOKE_STATE_SEED = new BN(0);
+//# sourceMappingURL=constants.js.map

package/dist/esm/src/svm/web3-v1/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/svm/web3-v1/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,OAAO,CAAC;AAEvB,MAAM,CAAC,MAAM,0BAA0B,GAAG,qCAAqC,CAAC;AAChF,MAAM,CAAC,MAAM,2BAA2B,GAAG,6BAA6B,CAAC;AACzE,MAAM,CAAC,MAAM,mBAAmB,GAAG,8CAA8C,CAAC;AAClF,MAAM,CAAC,MAAM,kBAAkB,GAAG,8CAA8C,CAAC;AACjF,MAAM,CAAC,MAAM,wCAAwC,GAAG,4CAA4C,CAAC;AACrG,MAAM,CAAC,MAAM,wCAAwC,GAAG,4CAA4C,CAAC;AACrG,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC"}

package/dist/esm/src/svm/web3-v1/conversionUtils.d.ts

@@ -0,0 +1,39 @@
+import { BN } from "@coral-xyz/anchor";
+import { PublicKey } from "@solana/web3.js";
+import { BigNumber } from "ethers";
+/**
+ * Converts an integer to a 32-byte Uint8Array.
+ */
+export declare function intToU8Array32(num: number | BN): number[];
+/**
+ * Converts a 32-byte Uint8Array to a bigint.
+ */
+export declare function u8Array32ToInt(u8Array: Uint8Array | number[]): bigint;
+/**
+ * Converts a 32-byte Uint8Array to a BigNumber.
+ */
+export declare function u8Array32ToBigNumber(u8Array: Uint8Array | number[]): BigNumber;
+/**
+ * Converts a string to a PublicKey.
+ */
+export declare function strPublicKey(publicKey: PublicKey): string;
+/**
+ * Converts an EVM address to a Solana PublicKey.
+ */
+export declare const evmAddressToPublicKey: (address: string) => PublicKey;
+/**
+ * Converts a Solana PublicKey to an EVM address.
+ */
+export declare const publicKeyToEvmAddress: (publicKey: PublicKey | string) => string;
+/**
+ * Converts a base58 string to a bytes32 string.
+ */
+export declare const fromBase58ToBytes32: (input: string) => string;
+/**
+ * Converts a bytes32 string to an EVM address.
+ */
+export declare const fromBytes32ToAddress: (input: string) => string;
+/**
+ * Converts EVM or SVM address to a bytes32 string.
+ */
+export declare const addressOrBase58ToBytes32: (input: string) => string;

package/dist/esm/src/svm/web3-v1/conversionUtils.js

@@ -0,0 +1,94 @@
+import { utils as anchorUtils, BN } from "@coral-xyz/anchor";
+import { PublicKey } from "@solana/web3.js";
+import { BigNumber, ethers } from "ethers";
+/**
+ * Converts an integer to a 32-byte Uint8Array.
+ */
+export function intToU8Array32(num) {
+    const bigIntValue = BigInt(num instanceof BN ? num.toString() : num);
+    if (bigIntValue < 0)
+        throw new Error("Input must be a non-negative integer or BN");
+    const hexString = bigIntValue.toString(16).padStart(64, "0"); // 32 bytes = 64 hex chars
+    const u8Array = Array.from(Buffer.from(hexString, "hex"));
+    return u8Array;
+}
+/**
+ * Converts a 32-byte Uint8Array to a bigint.
+ */
+export function u8Array32ToInt(u8Array) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const isValidArray = (arr) => Array.isArray(arr) && arr.every(Number.isInteger);
+    if ((u8Array instanceof Uint8Array || isValidArray(u8Array)) && u8Array.length === 32) {
+        return Array.from(u8Array).reduce((num, byte) => (num << BigInt(8)) | BigInt(byte), BigInt(0));
+    }
+    throw new Error("Input must be a Uint8Array or an array of 32 numbers.");
+}
+/**
+ * Converts a 32-byte Uint8Array to a BigNumber.
+ */
+export function u8Array32ToBigNumber(u8Array) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const isValidArray = (arr) => Array.isArray(arr) && arr.every(Number.isInteger);
+    if ((u8Array instanceof Uint8Array || isValidArray(u8Array)) && u8Array.length === 32) {
+        const hexString = "0x" + Buffer.from(u8Array).toString("hex");
+        return BigNumber.from(hexString);
+    }
+    throw new Error("Input must be a Uint8Array or an array of 32 numbers.");
+}
+/**
+ * Converts a string to a PublicKey.
+ */
+export function strPublicKey(publicKey) {
+    return new PublicKey(publicKey).toString();
+}
+/**
+ * Converts an EVM address to a Solana PublicKey.
+ */
+export const evmAddressToPublicKey = (address) => {
+    const bytes32Address = `0x000000000000000000000000${address.replace("0x", "")}`;
+    return new PublicKey(ethers.utils.arrayify(bytes32Address));
+};
+/**
+ * Converts a Solana PublicKey to an EVM address.
+ */
+export const publicKeyToEvmAddress = (publicKey) => {
+    // Convert the input to a PublicKey if it's a string
+    const pubKeyBuffer = typeof publicKey === "string" ? new PublicKey(publicKey).toBuffer() : publicKey.toBuffer();
+    // Extract the last 20 bytes to get the Ethereum address
+    const addressBuffer = pubKeyBuffer.slice(-20);
+    // Convert the buffer to a hex string and prepend '0x'
+    return `0x${addressBuffer.toString("hex")}`;
+};
+/**
+ * Converts a base58 string to a bytes32 string.
+ */
+export const fromBase58ToBytes32 = (input) => {
+    const decodedBytes = anchorUtils.bytes.bs58.decode(input);
+    return "0x" + Buffer.from(decodedBytes).toString("hex");
+};
+/**
+ * Converts a bytes32 string to an EVM address.
+ */
+export const fromBytes32ToAddress = (input) => {
+    const hexString = input.startsWith("0x") ? input.slice(2) : input;
+    if (hexString.length !== 64) {
+        throw new Error("Invalid bytes32 string");
+    }
+    const address = hexString.slice(-40);
+    return "0x" + address;
+};
+/**
+ * Converts EVM or SVM address to a bytes32 string.
+ */
+export const addressOrBase58ToBytes32 = (input) => {
+    if (ethers.utils.isAddress(input)) {
+        return ethers.utils.hexZeroPad(input, 32);
+    }
+    else if (ethers.utils.isHexString(input, 32)) {
+        return input;
+    }
+    else {
+        return fromBase58ToBytes32(input);
+    }
+};
+//# sourceMappingURL=conversionUtils.js.map

package/dist/esm/src/svm/web3-v1/conversionUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversionUtils.js","sourceRoot":"","sources":["../../../../../src/svm/web3-v1/conversionUtils.ts"],"names":[],"mappings":"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"}