@ar.io/sdk 4.0.0-solana.8 → 4.0.0

package/lib/types/types/token.d.ts

@@ -31,16 +31,4 @@ export declare class mARIOToken extends PositiveFiniteInteger {
     minus(subtractHend: mARIOToken): mARIOToken;
     toARIO(): ARIOToken;
 }
-export type AoSigner = (args: {
-    data: string | Buffer;
-    tags?: {
-        name: string;
-        value: string;
-    }[];
-    target?: string;
-    anchor?: string;
-}) => Promise<{
-    id: string;
-    raw: ArrayBuffer;
-}>;
 export {};

package/lib/types/utils/ant.d.ts

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { ANTRecords, AoANTState, HyperBeamANTState, SortedANTRecords } from '../types/ant.js';
+import { ANTRecords, SortedANTRecords } from '../types/ant.js';
 /**
  * Sorts ANT records by priority and then lexicographically.
  *
@@ -24,14 +24,3 @@ import { ANTRecords, AoANTState, HyperBeamANTState, SortedANTRecords } from '../
  * @param antRecords - The ANT records to sort.
  */
 export declare const sortANTRecords: (antRecords: ANTRecords) => SortedANTRecords;
-/**
- * @deprecated - this is no longer necessary because HyperBeam now uses the AoANTState type
- */
-export declare const isHyperBeamANTState: (state: any) => state is HyperBeamANTState;
-/**
- * Convert HyperBeam serialized ANT state to backwards compatible format.
- *
- * @deprecated - this is no longer necessary because HyperBeam now uses the AOANTState type
- * @param state - The HyperBeam serialized ANT state.
- */
-export declare const convertHyperBeamStateToAoANTState: (initialState: HyperBeamANTState) => AoANTState;

package/lib/types/utils/index.d.ts

@@ -13,10 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export * from './ao.js';
-export * from './arweave.js';
 export * from './base64.js';
 export * from './json.js';
-export * from './processes.js';
 export * from './schema.js';
 export * from './ant.js';

package/lib/types/version.d.ts

@@ -13,4 +13,4 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export declare const version = "4.0.0-solana.7";
+export declare const version = "4.0.0-alpha.4";

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@ar.io/sdk",
-  "version": "4.0.0-solana.8",
+  "version": "4.0.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ar-io/ar-io-sdk.git"
   },
-  "main": "./lib/esm/node/index.js",
-  "module": "./lib/esm/node/index.js",
-  "types": "./lib/types/node/index.d.ts",
+  "main": "./lib/esm/solana/index.js",
+  "module": "./lib/esm/solana/index.js",
+  "types": "./lib/types/solana/index.d.ts",
   "type": "module",
   "packageManager": "yarn@1.22.22",
   "engines": {
@@ -23,27 +23,22 @@
     "email": "info@ar.io",
     "website": "https://ar.io"
   },
-  "keywords": ["arweave", "ar", "blockchain", "ar.io", "ao", "solana"],
+  "keywords": ["arweave", "ar", "blockchain", "ar.io", "solana"],
   "exports": {
     ".": {
-      "types": "./lib/types/node/index.d.ts",
-      "import": "./lib/esm/node/index.js"
-    },
-    "./node": {
-      "types": "./lib/types/node/index.d.ts",
-      "import": "./lib/esm/node/index.js"
+      "types": "./lib/types/solana/index.d.ts",
+      "import": "./lib/esm/solana/index.js",
+      "default": "./lib/esm/solana/index.js"
     },
     "./web": {
-      "types": "./lib/types/web/index.d.ts",
-      "import": "./lib/esm/web/index.js"
+      "types": "./lib/types/solana/index.d.ts",
+      "import": "./lib/esm/solana/index.js",
+      "default": "./lib/esm/solana/index.js"
     },
     "./solana": {
       "types": "./lib/types/solana/index.d.ts",
-      "import": "./lib/esm/solana/index.js"
-    },
-    "./solana/generated": {
-      "types": "./lib/types/solana/generated/index.d.ts",
-      "import": "./lib/esm/solana/generated/index.js"
+      "import": "./lib/esm/solana/index.js",
+      "default": "./lib/esm/solana/index.js"
     }
   },
   "bin": {
@@ -58,25 +53,22 @@
     "lint:check": "biome check --unsafe",
     "format:fix": "biome format --write",
     "format:check": "biome format",
-    "test": "yarn test:unit && yarn test:e2e",
-    "test:esm": "yarn build:esm && yarn link && cd ./tests/e2e/esm && yarn && yarn test",
-    "test:web": "yarn build:esm && yarn link && cd ./tests/e2e/web && yarn && yarn test",
-    "test:unit": "c8 tsx --test --test-reporter=spec --enable-source-maps --trace-warnings $(find src -type f -name '*.test.ts')",
+    "test": "yarn test:unit",
+    "test:unit": "c8 tsx --test --test-reporter=spec --enable-source-maps --trace-warnings $(find src -type f -name '*.test.ts' -not -name '*.localnet.test.ts' -not -name '*.cross.test.ts' -not -name '*.e2e.test.ts')",
     "test:link": "yarn build && yarn link",
-    "test:e2e": "yarn test:esm && yarn test:web",
-    "test:integration": "yarn build:esm && yarn link && cd ./tests/integration && yarn && yarn test",
+    "test:localnet:io-write": "tsx --test --test-reporter=spec src/solana/io-writeable.localnet.test.ts",
+    "sdk-e2e:up": "bash scripts/sdk-e2e-bootstrap.sh",
+    "test:sdk-e2e:run": "tsx --test --test-reporter=spec src/solana/sdk.e2e.test.ts",
+    "test:sdk-e2e": "bash -c 'set -a && source test/.env.e2e && set +a && yarn test:sdk-e2e:run'",
     "prepare": "husky install",
     "docs:update": "markdown-toc-gen insert README.md --max-depth 2",
     "example:esm": "cd examples/esm && yarn && node index.mjs",
     "example:web": "yarn build:web && http-server --port 8080 --host -o examples/web",
     "example:vite": "yarn build:esm && yarn link && cd examples/vite && yarn && yarn start",
-    "cli:local": "node lib/esm/cli/cli.js",
-    "codegen": "node ./scripts/codegen.mjs"
+    "cli:local": "node lib/esm/cli/cli.js"
   },
   "devDependencies": {
     "@biomejs/biome": "1.9.4",
-    "@codama/nodes-from-anchor": "^1.4.1",
-    "@codama/renderers-js": "2.1.0",
     "@commitlint/cli": "^17.1.2",
     "@commitlint/config-conventional": "^17.1.0",
     "@esbuild-plugins/node-modules-polyfill": "^0.2.2",
@@ -87,13 +79,13 @@
     "@swc/core": "^1.11.22",
     "@trivago/prettier-plugin-sort-imports": "^4.2.0",
     "@types/node": "^22.14.1",
+    "@types/opossum": "^8.1.9",
     "@types/prompts": "^2.4.9",
     "@types/sinon": "^10.0.15",
     "@typescript-eslint/eslint-plugin": "^5.62.0",
     "@typescript-eslint/parser": "^6.4.0",
     "arconnect": "^1.0.3",
     "c8": "^10.1.3",
-    "codama": "^1.6.0",
     "dotenv": "^16.4.5",
     "dotenv-cli": "^7.4.2",
     "esbuild": "^0.27.1",
@@ -122,22 +114,20 @@
     "typescript": "^5.1.6"
   },
   "dependencies": {
-    "@ar.io/solana-contracts": "0.1.0-devnet.0",
-    "@ardrive/turbo-sdk": "^1.19.0",
-    "@dha-team/arbundles": "^1.0.1",
-    "@permaweb/aoconnect": "0.0.68",
+    "@ar.io/solana-contracts": "1.0.0",
+    "@noble/hashes": "^1.8.0",
+    "@solana-program/address-lookup-table": "^0.11.0",
     "@solana-program/compute-budget": "^0.15.0",
     "@solana-program/token": "^0.13.0",
     "@solana/kit": "^6.8.0",
-    "arweave": "1.15.5",
-    "axios": "^1.13.2",
     "bs58": "^6.0.0",
     "commander": "^12.1.0",
-    "eventemitter3": "^5.0.1",
-    "prompts": "^2.4.2"
+    "opossum": "^9.0.0",
+    "prompts": "^2.4.2",
+    "zod": "^3.25.76"
   },
   "lint-staged": {
-    "**/*.{ts,js,mjs,cjs,md,json}": ["biome format --write"],
+    "**/*.{ts,js,mjs,cjs,json}": ["biome format --write"],
     "**/README.md": ["markdown-toc-gen insert --max-depth 2"]
   }
 }

package/lib/esm/common/ant-versions.js

@@ -1,87 +0,0 @@
-/**
- * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import { ANT_REGISTRY_ID } from '../constants.js';
-import { isProcessConfiguration, isProcessIdConfiguration, } from '../types/io.js';
-import { createAoSigner } from '../utils/ao.js';
-import { pruneTags } from '../utils/arweave.js';
-import { AOProcess } from './contracts/ao-process.js';
-import { InvalidContractConfigurationError } from './error.js';
-export class ANTVersions {
-    static init(config) {
-        if (config !== undefined && 'signer' in config) {
-            return new ANTVersionsWritable(config);
-        }
-        return new ANTVersionsReadable(config);
-    }
-}
-export class ANTVersionsReadable {
-    process;
-    constructor(config) {
-        if (config === undefined || Object.keys(config).length === 0) {
-            this.process = new AOProcess({
-                processId: ANT_REGISTRY_ID,
-            });
-        }
-        else if (isProcessConfiguration(config)) {
-            this.process = config.process;
-        }
-        else if (isProcessIdConfiguration(config)) {
-            this.process = new AOProcess({
-                processId: config.processId,
-            });
-        }
-        else {
-            throw new InvalidContractConfigurationError();
-        }
-    }
-    async getANTVersions() {
-        const res = await this.process.read({
-            tags: [{ name: 'Action', value: 'Get-Versions' }],
-        });
-        return Object.fromEntries(Object.entries(res).sort(([a], [b]) => a.localeCompare(b)));
-    }
-    async getLatestANTVersion() {
-        const versions = await this.getANTVersions();
-        const lastestVersion = Object.entries(versions).at(-1);
-        if (!lastestVersion)
-            throw new Error('No version found');
-        return {
-            version: lastestVersion[0],
-            ...lastestVersion[1],
-        };
-    }
-}
-export class ANTVersionsWritable extends ANTVersionsReadable {
-    signer;
-    constructor({ signer, ...config }) {
-        super(config);
-        this.signer = createAoSigner(signer);
-    }
-    async addVersion(params, options) {
-        const { version, moduleId, luaSourceId, notes } = params;
-        return this.process.send({
-            tags: pruneTags([
-                { name: 'Action', value: 'Add-Version' },
-                { name: 'Version', value: version },
-                { name: 'Module-Id', value: moduleId },
-                { name: 'Lua-Source-Id', value: luaSourceId },
-                { name: 'Notes', value: notes },
-                ...(options?.tags ?? []),
-            ]),
-            signer: this.signer,
-        });
-    }
-}

package/lib/esm/common/arweave.js

@@ -1,21 +0,0 @@
-/**
- * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import Arweave from 'arweave/node/index.js';
-export const defaultArweave = Arweave.init({
-    host: 'arweave.net',
-    port: 443,
-    protocol: 'https',
-});

package/lib/esm/common/contracts/ao-process.js

@@ -1,218 +0,0 @@
-/**
- * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import { connect } from '@permaweb/aoconnect';
-import { getRandomText } from '../../utils/base64.js';
-import { errorMessageFromOutput } from '../../utils/index.js';
-import { safeDecode } from '../../utils/json.js';
-import { version } from '../../version.js';
-import { WriteInteractionError } from '../error.js';
-import { Logger } from '../logger.js';
-export class AOProcess {
-    logger;
-    ao;
-    processId;
-    constructor({ processId, ao = connect({
-        MODE: 'legacy',
-    }), logger = Logger.default, }) {
-        this.processId = processId;
-        this.logger = logger;
-        this.ao = ao;
-    }
-    isMessageDataEmpty(messageData) {
-        return (messageData === undefined ||
-            messageData === 'null' || // This is what the CU returns for 'nil' values that are json.encoded
-            messageData === '' ||
-            messageData === null);
-    }
-    async read({ tags, retries = 3, fromAddress, }) {
-        this.logger.debug(`Evaluating read interaction on process`, {
-            tags,
-            processId: this.processId,
-        });
-        // map tags to inputs
-        const dryRunInput = {
-            process: this.processId,
-            tags,
-        };
-        if (fromAddress !== undefined) {
-            dryRunInput['Owner'] = fromAddress;
-        }
-        let attempts = 0;
-        let result = undefined;
-        while (attempts < retries) {
-            try {
-                result = await this.ao.dryrun(dryRunInput);
-                // break on successful return of result
-                break;
-            }
-            catch (error) {
-                attempts++;
-                this.logger.debug(`Read attempt ${attempts} failed`, {
-                    error: error?.message,
-                    stack: error?.stack,
-                    tags,
-                    processId: this.processId,
-                });
-                if (attempts >= retries) {
-                    this.logger.debug(`Maximum read attempts exceeded`, {
-                        error: error?.message,
-                        stack: error?.stack,
-                        tags,
-                        processId: this.processId,
-                        ao: JSON.stringify(this.ao),
-                    });
-                    throw new Error(`Failed to evaluate dry-run on process ${this.processId}.`, {
-                        cause: error,
-                    });
-                }
-                // exponential backoff
-                await new Promise((resolve) => setTimeout(resolve, 2 ** attempts * 1000));
-            }
-        }
-        if (result === undefined) {
-            throw new Error('Unexpected error when evaluating read interaction');
-        }
-        this.logger.debug(`Read interaction result`, {
-            result,
-            processId: this.processId,
-        });
-        const error = errorMessageFromOutput(result);
-        if (error !== undefined) {
-            throw new Error(error);
-        }
-        if (result.Messages === undefined || result.Messages.length === 0) {
-            this.logger.debug(`Empty result - process ${this.processId} does not support provided action.`, {
-                result,
-                tags,
-                processId: this.processId,
-            });
-            throw new Error(result.message ||
-                `Process ${this.processId} did not return a valid response. Response: ${JSON.stringify(result)}`);
-        }
-        const messageData = result.Messages?.[0]?.Data;
-        // return undefined if no data is returned
-        if (this.isMessageDataEmpty(messageData)) {
-            return undefined;
-        }
-        const response = safeDecode(messageData);
-        return response;
-    }
-    async send({ tags, data, signer, retries = 3, }) {
-        let messageId;
-        const anchor = getRandomText(32); // anchor is a random text produce non-deterministic messages IDs when deterministic signers are provided (ETH)
-        try {
-            this.logger.debug(`Evaluating send interaction on contract`, {
-                tags,
-                data,
-                processId: this.processId,
-            });
-            /**
-             * DO NOT retry messaging if a message was already sent.
-             * This could result in a double entry-like condition when sending tokens for example.
-             * If the message fails to send we will throw an error and the caller can retry.
-             */
-            messageId = await this.ao.message({
-                process: this.processId,
-                tags: [...tags, { name: 'AR-IO-SDK', value: version }],
-                data,
-                signer,
-                anchor,
-            });
-            this.logger.debug(`Sent message to process`, {
-                messageId,
-                processId: this.processId,
-                anchor,
-            });
-        }
-        catch (error) {
-            this.logger.debug('Error sending message to process', {
-                error: error?.message,
-                stack: error?.stack,
-                processId: this.processId,
-                tags,
-            });
-            // throw the error so it can be handled by the caller
-            throw error;
-        }
-        if (messageId === undefined) {
-            throw new Error('Failed to send message to process.');
-        }
-        // get the result of the message before returning, using retries to handle network errors/new process delays
-        let result = undefined;
-        let attempts = 0;
-        while (attempts < retries) {
-            try {
-                result = await this.ao.result({
-                    message: messageId,
-                    process: this.processId,
-                });
-                this.logger.debug('Message result', {
-                    result,
-                    messageId,
-                    processId: this.processId,
-                });
-                break;
-            }
-            catch (error) {
-                attempts++;
-                this.logger.debug('Retrying send interaction', {
-                    attempts,
-                    retries,
-                    error: error?.message,
-                    processId: this.processId,
-                });
-                if (attempts >= retries) {
-                    this.logger.debug(`Message was sent to process ${this.processId} with id ${messageId} but result was not returned. Review transactions for more details.`, {
-                        error: error?.message,
-                        stack: error?.stack,
-                        tags,
-                        processId: this.processId,
-                        messageId,
-                    });
-                    return { id: messageId };
-                }
-                // exponential backoff
-                await new Promise((resolve) => setTimeout(resolve, 2 ** attempts * 2000));
-            }
-        }
-        if (result === undefined) {
-            this.logger.debug(`Message was sent to process ${this.processId} with id ${messageId} but the result was not returned. Review transactions for more details.`, {
-                tags,
-                processId: this.processId,
-                messageId,
-            });
-            return { id: messageId };
-        }
-        const error = errorMessageFromOutput(result);
-        if (error !== undefined) {
-            throw new WriteInteractionError(error);
-        }
-        // check if there are any Messages in the output
-        if (result.Messages?.length === 0 || result.Messages === undefined) {
-            return { id: messageId };
-        }
-        if (this.isMessageDataEmpty(result.Messages[0].Data)) {
-            return { id: messageId };
-        }
-        const resultData = safeDecode(result.Messages[0].Data);
-        this.logger.debug('Message result data', {
-            resultData,
-            messageId,
-            processId: this.processId,
-        });
-        return { id: messageId, result: resultData };
-    }
-}