@ar.io/sdk 3.24.0 → 4.0.0-solana.3

package/lib/cjs/cli/utils.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -47,9 +80,12 @@ exports.requiredStringArrayFromOptions = requiredStringArrayFromOptions;
 exports.positiveIntegerFromOptions = positiveIntegerFromOptions;
 exports.requiredPositiveIntegerFromOptions = requiredPositiveIntegerFromOptions;
 exports.getANTStateFromOptions = getANTStateFromOptions;
+exports.spawnSolanaANTFromOptions = spawnSolanaANTFromOptions;
 exports.getTokenCostParamsFromOptions = getTokenCostParamsFromOptions;
 exports.fundFromFromOptions = fundFromFromOptions;
 exports.referrerFromOptions = referrerFromOptions;
+exports.withdrawalIdFromOptions = withdrawalIdFromOptions;
+exports.fundingPlanFromOptions = fundingPlanFromOptions;
 exports.assertLockLengthInRange = assertLockLengthInRange;
 exports.antRecordMetadataFromOptions = antRecordMetadataFromOptions;
 /**
@@ -68,23 +104,10 @@ exports.antRecordMetadataFromOptions = antRecordMetadataFromOptions;
  * limitations under the License.
  */
 const fs_1 = require("fs");
-/**
- * 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.
- */
 const arbundles_1 = require("@dha-team/arbundles");
 const aoconnect_1 = require("@permaweb/aoconnect");
+const kit_1 = require("@solana/kit");
+const bs58_1 = __importDefault(require("bs58"));
 const commander_1 = require("commander");
 const prompts_1 = __importDefault(require("prompts"));
 const index_js_1 = require("../node/index.js");
@@ -195,19 +218,46 @@ function aoProcessFromOptions(options) {
 }
 function readARIOFromOptions(options) {
     setLoggerIfDebug(options);
+    if (options.ao) {
+        return index_js_1.ARIO.init({
+            hyperbeamUrl: options.hyperbeamUrl,
+            process: aoProcessFromOptions({
+                cuUrl: 'http://localhost:6363',
+                ...options,
+            }),
+            paymentUrl: options.paymentUrl,
+        });
+    }
+    const rpcUrl = options.rpcUrl ?? 'https://api.mainnet-beta.solana.com';
     return index_js_1.ARIO.init({
-        hyperbeamUrl: options.hyperbeamUrl,
-        process: aoProcessFromOptions({
-            cuUrl: index_js_1.DEFAULT_CU_URL,
-            ...options,
-        }),
-        paymentUrl: options.paymentUrl,
+        backend: 'solana',
+        rpc: (0, kit_1.createSolanaRpc)(rpcUrl),
+        ...(options.coreProgramId
+            ? { coreProgramId: (0, kit_1.address)(options.coreProgramId) }
+            : {}),
+        ...(options.garProgramId
+            ? { garProgramId: (0, kit_1.address)(options.garProgramId) }
+            : {}),
+        ...(options.arnsProgramId
+            ? { arnsProgramId: (0, kit_1.address)(options.arnsProgramId) }
+            : {}),
     });
 }
-function readANTRegistryFromOptions(options) {
+async function readANTRegistryFromOptions(options) {
+    setLoggerIfDebug(options);
+    if (options.ao) {
+        return index_js_1.ANTRegistry.init({
+            process: aoProcessFromOptions(options),
+            hyperbeamUrl: options.hyperbeamUrl,
+        });
+    }
+    const rpcUrl = options.rpcUrl ?? 'https://api.mainnet-beta.solana.com';
     return index_js_1.ANTRegistry.init({
-        process: aoProcessFromOptions(options),
-        hyperbeamUrl: options.hyperbeamUrl,
+        backend: 'solana',
+        rpc: (0, kit_1.createSolanaRpc)(rpcUrl),
+        ...(options.antProgramId
+            ? { antProgramId: (0, kit_1.address)(options.antProgramId) }
+            : {}),
     });
 }
 function contractSignerFromOptions(options) {
@@ -235,17 +285,85 @@ function requiredContractSignerFromOptions(options) {
 function requiredAoSignerFromOptions(options) {
     return (0, index_js_1.createAoSigner)(requiredContractSignerFromOptions(options).signer);
 }
-function writeARIOFromOptions(options) {
-    const { signer, signerAddress } = requiredContractSignerFromOptions(options);
+/** Derive a WS URL from an HTTP/HTTPS RPC URL by swapping the scheme. */
+function wsUrlFromRpcUrl(rpcUrl) {
+    // Surfpool and `solana-test-validator` follow Solana's well-known localhost
+    // convention: HTTP RPC on 8899 and WebSocket on 8900 (a separate port).
+    // Public RPCs (mainnet/devnet/testnet) put both on the same port (443/443),
+    // so a naive `http→ws` swap works there but breaks against any local
+    // validator. Bump the port iff we recognise the localhost+8899 pair.
+    let url;
+    try {
+        url = new URL(rpcUrl);
+    }
+    catch {
+        return rpcUrl.replace(/^http/, 'ws');
+    }
+    const isLocalhost = url.hostname === 'localhost' ||
+        url.hostname === '127.0.0.1' ||
+        url.hostname === '0.0.0.0';
+    if (isLocalhost && url.port === '8899') {
+        url.port = '8900';
+    }
+    url.protocol = url.protocol === 'https:' ? 'wss:' : 'ws:';
+    return url.toString().replace(/\/$/, '');
+}
+/**
+ * Load a Solana KeyPairSigner from --private-key (base58) or --wallet-file
+ * (JSON array of bytes). Throws with a helpful message if neither is set.
+ */
+async function loadSolanaSignerFromOptions(options) {
+    let secretKey;
+    if (options.privateKey) {
+        secretKey = bs58_1.default.decode(options.privateKey);
+    }
+    else if (options.walletFile) {
+        const raw = (0, fs_1.readFileSync)(options.walletFile, 'utf-8');
+        secretKey = new Uint8Array(JSON.parse(raw));
+    }
+    else {
+        throw new Error('Solana write operations require a signer.\n' +
+            'Provide a Solana keypair with --wallet-file <path-to-keypair.json> ' +
+            'or --private-key <base58-encoded-key>');
+    }
+    return (0, kit_1.createKeyPairSignerFromBytes)(secretKey);
+}
+async function writeARIOFromOptions(options) {
     setLoggerIfDebug(options);
+    if (options.ao) {
+        const { signer, signerAddress } = requiredContractSignerFromOptions(options);
+        return {
+            ario: index_js_1.ARIO.init({
+                process: aoProcessFromOptions(options),
+                signer,
+                paymentUrl: options.paymentUrl,
+                hyperbeamUrl: options.hyperbeamUrl,
+            }),
+            signerAddress,
+        };
+    }
+    const rpcUrl = options.rpcUrl ?? 'https://api.mainnet-beta.solana.com';
+    const signer = await loadSolanaSignerFromOptions(options);
     return {
         ario: index_js_1.ARIO.init({
-            process: aoProcessFromOptions(options),
+            backend: 'solana',
+            rpc: (0, kit_1.createSolanaRpc)(rpcUrl),
+            rpcSubscriptions: (0, kit_1.createSolanaRpcSubscriptions)(wsUrlFromRpcUrl(rpcUrl)),
             signer,
-            paymentUrl: options.paymentUrl,
-            hyperbeamUrl: options.hyperbeamUrl,
+            // Forward program-id overrides to mirror `readARIOFromOptions` so
+            // localnet / devnet writes target the deployed program IDs instead of
+            // silently falling back to the SDK's mainnet defaults.
+            ...(options.coreProgramId
+                ? { coreProgramId: (0, kit_1.address)(options.coreProgramId) }
+                : {}),
+            ...(options.garProgramId
+                ? { garProgramId: (0, kit_1.address)(options.garProgramId) }
+                : {}),
+            ...(options.arnsProgramId
+                ? { arnsProgramId: (0, kit_1.address)(options.arnsProgramId) }
+                : {}),
         }),
-        signerAddress,
+        signerAddress: signer.address,
     };
 }
 function formatARIOWithCommas(value) {
@@ -507,18 +625,43 @@ function ANTProcessFromOptions(options) {
         }),
     });
 }
-function readANTFromOptions(options) {
+async function readANTFromOptions(options) {
+    if (options.ao) {
+        return index_js_1.ANT.init({
+            process: ANTProcessFromOptions(options),
+            hyperbeamUrl: options.hyperbeamUrl,
+        });
+    }
+    const rpcUrl = options.rpcUrl ?? 'https://api.mainnet-beta.solana.com';
     return index_js_1.ANT.init({
-        process: ANTProcessFromOptions(options),
-        hyperbeamUrl: options.hyperbeamUrl,
+        backend: 'solana',
+        processId: requiredProcessIdFromOptions(options),
+        rpc: (0, kit_1.createSolanaRpc)(rpcUrl),
+        ...(options.antProgramId
+            ? { antProgramId: (0, kit_1.address)(options.antProgramId) }
+            : {}),
     });
 }
-function writeANTFromOptions(options, signer) {
-    signer ??= requiredContractSignerFromOptions(options).signer;
+async function writeANTFromOptions(options, signer) {
+    if (options.ao) {
+        signer ??= requiredContractSignerFromOptions(options).signer;
+        return index_js_1.ANT.init({
+            process: ANTProcessFromOptions(options),
+            signer,
+            hyperbeamUrl: options.hyperbeamUrl,
+        });
+    }
+    const rpcUrl = options.rpcUrl ?? 'https://api.mainnet-beta.solana.com';
+    const kitSigner = await loadSolanaSignerFromOptions(options);
     return index_js_1.ANT.init({
-        process: ANTProcessFromOptions(options),
-        signer,
-        hyperbeamUrl: options.hyperbeamUrl,
+        backend: 'solana',
+        processId: requiredProcessIdFromOptions(options),
+        rpc: (0, kit_1.createSolanaRpc)(rpcUrl),
+        rpcSubscriptions: (0, kit_1.createSolanaRpcSubscriptions)(wsUrlFromRpcUrl(rpcUrl)),
+        signer: kitSigner,
+        ...(options.antProgramId
+            ? { antProgramId: (0, kit_1.address)(options.antProgramId) }
+            : {}),
     });
 }
 function booleanFromOptions(options, key) {
@@ -581,6 +724,60 @@ function getANTStateFromOptions(options) {
             : exports.defaultTtlSecondsCLI,
     });
 }
+/**
+ * Spawn a fresh ANT on Solana from CLI options.
+ *
+ * Resolves the signer the same way `writeARIOFromOptions` does (KeyPairSigner
+ * from `--wallet-file` or `--private-key`), then bundles MPL Core `CreateV1` +
+ * `ario_ant::initialize` into a single transaction. The signer's address
+ * becomes the ANT owner on chain — no separate `--address` is required.
+ *
+ * Maps the CLI's AO-shaped options (`--name`, `--ticker`, `--description`,
+ * `--keywords`, `--logo`, `--target` for the @ record tx id) onto the Solana
+ * `InitializeAntParams` payload. AO-only state fields like `controllers` and
+ * `balances` are intentionally dropped — they don't exist on Solana.
+ */
+async function spawnSolanaANTFromOptions(options) {
+    setLoggerIfDebug(options);
+    const { spawnSolanaANT } = await Promise.resolve().then(() => __importStar(require('../solana/spawn-ant.js')));
+    const rpcUrl = options.rpcUrl ?? 'https://api.mainnet-beta.solana.com';
+    const kitSigner = await loadSolanaSignerFromOptions(options);
+    const name = options.name ?? `ANT-${kitSigner.address.slice(0, 8)}`;
+    // ANT NFT metadata URI — required so the asset renders correctly in
+    // marketplaces. Caller must upload a JSON metadata file (build via
+    // `buildAntMetadata` from `@ar.io/sdk/solana`, host on Arweave via Turbo
+    // or any other gateway) and pass the resulting URI here.
+    const metadataUri = options.metadataUri;
+    if (!metadataUri || typeof metadataUri !== 'string') {
+        throw new Error('spawn-ant: --metadata-uri is required.\n\n' +
+            'Build the JSON metadata with `buildAntMetadata` from `@ar.io/sdk/solana`,\n' +
+            'upload it to Arweave (free for files under 100 KiB via @ardrive/turbo-sdk\n' +
+            'with a `HexSolanaSigner`), then pass the resulting URI:\n' +
+            '  --metadata-uri "ar://<txid>"            (canonical AR.IO scheme)\n' +
+            '  --metadata-uri "https://<gateway>/raw/<txid>"   (immediate render)\n\n' +
+            'See sdk/scripts/devnet-validation/populate-ant.ts for an end-to-end example.');
+    }
+    return spawnSolanaANT({
+        rpc: (0, kit_1.createSolanaRpc)(rpcUrl),
+        rpcSubscriptions: (0, kit_1.createSolanaRpcSubscriptions)(wsUrlFromRpcUrl(rpcUrl)),
+        signer: kitSigner,
+        state: {
+            name,
+            uri: metadataUri,
+            ticker: options.ticker,
+            description: options.description,
+            keywords: options.keywords,
+            logo: options.logo,
+            // `--target` is the AO convention for the @ record's tx id (see
+            // initANTStateForAddress). Reuse it on Solana so the CLI surface stays
+            // identical between backends.
+            transactionId: options.target,
+        },
+        ...(options.antProgramId
+            ? { antProgramId: (0, kit_1.address)(options.antProgramId) }
+            : {}),
+    });
+}
 function getTokenCostParamsFromOptions(o) {
     o.intent ??= 'Buy-Name';
     o.type ??= 'lease';
@@ -611,6 +808,86 @@ function fundFromFromOptions(o) {
 function referrerFromOptions(o) {
     return o.referrer;
 }
+/** Parse `--withdrawal-id` from CLI options into a bigint. */
+function withdrawalIdFromOptions(o) {
+    if (o.withdrawalId === undefined)
+        return undefined;
+    try {
+        return BigInt(o.withdrawalId);
+    }
+    catch {
+        throw new Error(`Invalid --withdrawal-id: '${o.withdrawalId}' is not a valid u64 integer`);
+    }
+}
+/**
+ * Parse `--funding-plan-json` into a `FundingSourceSpec[]`. Validates each
+ * entry's `kind` against the on-chain enum and parses `amount` as a bigint.
+ * Each Delegation/OperatorStake entry MAY carry a `gateway` field (base58
+ * Solana address) — required when the plan spans multiple gateways.
+ *
+ * Format examples:
+ *   '[{"kind":"balance","amount":"100"},{"kind":"withdrawal","amount":"500"}]'
+ *   '[{"kind":"delegation","amount":"100","gateway":"Gw1..."},{"kind":"delegation","amount":"50","gateway":"Gw2..."}]'
+ *
+ * Returns undefined when the flag isn't set; throws Error on malformed JSON
+ * or unknown kinds.
+ */
+function fundingPlanFromOptions(o) {
+    if (!o.fundingPlanJson)
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(o.fundingPlanJson);
+    }
+    catch (err) {
+        throw new Error(`--funding-plan-json is not valid JSON: ${err.message}`);
+    }
+    if (!Array.isArray(parsed)) {
+        throw new Error('--funding-plan-json must be a JSON array');
+    }
+    const validKinds = new Set([
+        'balance',
+        'delegation',
+        'operatorStake',
+        'withdrawal',
+    ]);
+    return parsed.map((entry, idx) => {
+        if (typeof entry !== 'object' ||
+            entry === null ||
+            typeof entry.kind !== 'string' ||
+            typeof entry.amount !== 'string') {
+            throw new Error(`--funding-plan-json[${idx}] must be { kind: string, amount: string, gateway?: string }`);
+        }
+        const e = entry;
+        if (!validKinds.has(e.kind)) {
+            throw new Error(`--funding-plan-json[${idx}].kind must be one of ${[...validKinds].join(', ')} (got '${e.kind}')`);
+        }
+        let amount;
+        try {
+            amount = BigInt(e.amount);
+        }
+        catch {
+            throw new Error(`--funding-plan-json[${idx}].amount '${e.amount}' is not a valid u64`);
+        }
+        if (amount <= 0n) {
+            throw new Error(`--funding-plan-json[${idx}].amount must be > 0 (got ${e.amount})`);
+        }
+        const out = {
+            kind: e.kind,
+            amount,
+        };
+        if (e.gateway !== undefined) {
+            if (typeof e.gateway !== 'string') {
+                throw new Error(`--funding-plan-json[${idx}].gateway must be a base58 Solana address`);
+            }
+            if (e.kind !== 'delegation' && e.kind !== 'operatorStake') {
+                throw new Error(`--funding-plan-json[${idx}].gateway is only valid for kind 'delegation' or 'operatorStake' (got '${e.kind}')`);
+            }
+            out.gateway = e.gateway;
+        }
+        return out;
+    });
+}
 function assertLockLengthInRange(lockLengthMs, assertMin = true) {
     const minLockLengthMs = 1209600000; // 14 days
     const maxLockLengthMs = 378432000000; // ~12 years

package/lib/cjs/common/ant-registry.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AoANTRegistryWriteable = exports.AoANTRegistryReadable = exports.ANTRegistry = void 0;
 /**
@@ -23,10 +56,32 @@ const index_js_2 = require("./index.js");
 const logger_js_1 = require("./logger.js");
 class ANTRegistry {
     static init(config) {
-        if (config !== undefined && 'signer' in config) {
-            return new AoANTRegistryWriteable(config);
+        if (config && 'backend' in config && config.backend === 'solana') {
+            return (async () => {
+                if ('signer' in config) {
+                    const { SolanaANTRegistryWriteable } = await Promise.resolve().then(() => __importStar(require('../solana/ant-registry-writeable.js')));
+                    return new SolanaANTRegistryWriteable({
+                        rpc: config.rpc,
+                        signer: config.signer,
+                        commitment: config.commitment,
+                        logger: config.logger,
+                        antProgramId: config.antProgramId,
+                    });
+                }
+                const { SolanaANTRegistryReadable } = await Promise.resolve().then(() => __importStar(require('../solana/ant-registry-readable.js')));
+                return new SolanaANTRegistryReadable({
+                    rpc: config.rpc,
+                    commitment: config.commitment,
+                    logger: config.logger,
+                    antProgramId: config.antProgramId,
+                });
+            })();
+        }
+        const aoConfig = config;
+        if (aoConfig !== undefined && 'signer' in aoConfig) {
+            return new AoANTRegistryWriteable(aoConfig);
         }
-        return new AoANTRegistryReadable(config);
+        return new AoANTRegistryReadable(aoConfig);
     }
 }
 exports.ANTRegistry = ANTRegistry;

package/lib/cjs/common/ant.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AoANTWriteable = exports.AoANTReadable = exports.ANT = void 0;
 /**
@@ -35,10 +68,14 @@ class ANT {
     static get versions() {
         return ant_versions_js_1.ANTVersions.init();
     }
-    /**
-     * Spawn a new ANT.
-     */
-    static spawn = ao_js_1.spawnANT;
+    static async spawn(params) {
+        if (params && params.backend === 'solana') {
+            const { spawnSolanaANT } = await Promise.resolve().then(() => __importStar(require('../solana/spawn-ant.js')));
+            const { backend: _backend, ...rest } = params;
+            return spawnSolanaANT(rest);
+        }
+        return (0, ao_js_1.spawnANT)(params);
+    }
     /**
      * Fork an ANT to a new process.
      *
@@ -191,7 +228,48 @@ class ANT {
         return { forkedProcessId, reassignedNames, failedReassignedNames };
     }
     static init(config) {
-        if (config !== undefined && 'signer' in config) {
+        // Solana backend — async, loads transport lazily to keep AO-only bundles small
+        if ('backend' in config && config.backend === 'solana') {
+            return (async () => {
+                const { SolanaANTReadable } = await Promise.resolve().then(() => __importStar(require('../solana/ant-readable.js')));
+                const { SolanaANTWriteable } = await Promise.resolve().then(() => __importStar(require('../solana/ant-writeable.js')));
+                // ADR-016 / BD-100: when no explicit `antProgramId` is passed,
+                // resolve it from the asset's `ANT Program` Attributes-plugin
+                // entry. Without this auto-detection, third-party (BYO-ANT)
+                // assets would silently mis-derive PDAs through the canonical
+                // default. Users who already know the program (e.g. immediately
+                // after `ANT.spawn`) can short-circuit by passing it explicitly.
+                let antProgramId = config.antProgramId;
+                if (!antProgramId) {
+                    const { fetchAntProgramFromAsset } = await Promise.resolve().then(() => __importStar(require('../solana/mpl-core.js')));
+                    const { ARIO_ANT_PROGRAM_ID } = await Promise.resolve().then(() => __importStar(require('../solana/constants.js')));
+                    const { address } = await Promise.resolve().then(() => __importStar(require('@solana/kit')));
+                    const detected = await fetchAntProgramFromAsset(config.rpc, address(config.processId), { commitment: config.commitment ?? 'confirmed' });
+                    antProgramId = detected ?? ARIO_ANT_PROGRAM_ID;
+                }
+                if (config.signer) {
+                    if (!config.rpcSubscriptions) {
+                        throw new Error('ANT.init({ backend: "solana", signer }) requires rpcSubscriptions for transaction confirmation.');
+                    }
+                    return new SolanaANTWriteable({
+                        rpc: config.rpc,
+                        rpcSubscriptions: config.rpcSubscriptions,
+                        processId: config.processId,
+                        signer: config.signer,
+                        commitment: config.commitment,
+                        antProgramId,
+                    });
+                }
+                return new SolanaANTReadable({
+                    rpc: config.rpc,
+                    processId: config.processId,
+                    commitment: config.commitment,
+                    antProgramId,
+                });
+            })();
+        }
+        // AO backend (stays sync)
+        if ('signer' in config) {
             return new AoANTWriteable(config);
         }
         return new AoANTReadable(config);

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

@@ -40,7 +40,7 @@ class AOProcess {
             messageData === '' ||
             messageData === null);
     }
-    async read({ tags, retries = 3, fromAddress, select, }) {
+    async read({ tags, retries = 3, fromAddress, }) {
         this.logger.debug(`Evaluating read interaction on process`, {
             tags,
             processId: this.processId,
@@ -105,9 +105,7 @@ class AOProcess {
             throw new Error(result.message ||
                 `Process ${this.processId} did not return a valid response. Response: ${JSON.stringify(result)}`);
         }
-        const messageData = select
-            ? result.Messages.find(select)?.Data
-            : result.Messages?.[0]?.Data;
+        const messageData = result.Messages?.[0]?.Data;
         // return undefined if no data is returned
         if (this.isMessageDataEmpty(messageData)) {
             return undefined;
@@ -115,7 +113,7 @@ class AOProcess {
         const response = (0, json_js_1.safeDecode)(messageData);
         return response;
     }
-    async send({ tags, data, signer, retries = 3, select, }) {
+    async send({ tags, data, signer, retries = 3, }) {
         let messageId;
         const anchor = (0, base64_js_1.getRandomText)(32); // anchor is a random text produce non-deterministic messages IDs when deterministic signers are provided (ETH)
         try {
@@ -212,7 +210,7 @@ class AOProcess {
         if (this.isMessageDataEmpty(result.Messages[0].Data)) {
             return { id: messageId };
         }
-        const resultData = (0, json_js_1.safeDecode)(select ? result.Messages.find(select)?.Data : result.Messages[0].Data);
+        const resultData = (0, json_js_1.safeDecode)(result.Messages[0].Data);
         this.logger.debug('Message result data', {
             resultData,
             messageId,