@ar.io/sdk 4.0.0-solana.4 → 4.0.0-solana.5

package/lib/cjs/solana/io-writeable.js

@@ -73,6 +73,8 @@ function toGeneratedFundingSourceSpec(s) {
     };
     return { kind: kindMap[s.kind], amount: s.amount };
 }
+const token_1 = require("@solana-program/token");
+const constants_js_1 = require("./constants.js");
 const syncAttributes_js_1 = require("./generated/ant/instructions/syncAttributes.js");
 const index_js_4 = require("./generated/core/instructions/index.js");
 const delegation_js_1 = require("./generated/gar/accounts/delegation.js");
@@ -277,18 +279,25 @@ class SolanaARIOWriteable extends io_readable_js_1.SolanaARIOReadable {
         const mint = await this.getMint();
         const fromATA = await (0, ata_js_1.getAssociatedTokenAddressKit)(mint, this.signer.address);
         const toATA = await (0, ata_js_1.getAssociatedTokenAddressKit)(mint, recipient);
-        // The on-chain `Transfer` ix requires `to_token_account` to exist as a
-        // valid SPL TokenAccount (`AccountNotInitialized` #3012 otherwise).
-        // Bundle an idempotent CreateAssociatedTokenAccount so a fresh recipient
-        // wallet just works — same pattern as `vaultedTransfer` below. Idempotent
-        // means a second transfer to the same recipient is a no-op for this ix.
+        // SPL `transferChecked` requires the recipient ATA to exist; bundle
+        // an idempotent ATA-create so fresh recipients just work. Same
+        // pattern as `vaultedTransfer` below.
         const createToAtaIx = (0, ata_js_1.buildCreateAtaIdempotentIx)(this.signer.address, toATA, recipient, mint);
-        const ix = (0, index_js_4.getTransferInstruction)({
-            fromTokenAccount: fromATA,
-            toTokenAccount: toATA,
+        // Standard SPL Token `transferChecked`. The custom `ario-core::transfer`
+        // ix is deprecated — it added no protocol-level accounting, just wrapped
+        // this same CPI plus a `TransferEvent` emission that no major Solana
+        // indexer needs (Helius, Solscan, etc. all track SPL transfers natively).
+        // See `docs/REMOVE_CUSTOM_TRANSFER_PLAN.md` in `ar-io/solana-ar-io`.
+        // `transferChecked` (vs `transfer`) validates the mint + decimals
+        // on-chain, preventing cross-mint mistakes.
+        const ix = (0, token_1.getTransferCheckedInstruction)({
+            source: fromATA,
+            mint,
+            destination: toATA,
             authority: this.signer,
             amount,
-        }, { programAddress: this.coreProgram });
+            decimals: constants_js_1.TOKEN_DECIMALS,
+        });
         const sig = await this.sendTransaction([createToAtaIx, ix]);
         return { id: sig };
     }

package/lib/cjs/version.js

@@ -17,4 +17,4 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.version = void 0;
 // AUTOMATICALLY GENERATED FILE - DO NOT TOUCH
-exports.version = '4.0.0-solana.4';
+exports.version = '4.0.0-solana.5';

package/lib/esm/solana/io-writeable.js

@@ -36,8 +36,10 @@ function toGeneratedFundingSourceSpec(s) {
     };
     return { kind: kindMap[s.kind], amount: s.amount };
 }
+import { getTransferCheckedInstruction } from '@solana-program/token';
+import { TOKEN_DECIMALS } from './constants.js';
 import { getSyncAttributesInstruction } from './generated/ant/instructions/syncAttributes.js';
-import { getApprovePrimaryNameInstructionAsync, getCloseExpiredRequestInstruction, getCreateVaultInstructionAsync, getExtendVaultInstructionAsync, getIncreaseVaultInstructionAsync, getReleaseVaultInstructionAsync, getRequestAndSetPrimaryNameFromFundingPlanInstructionAsync, getRequestPrimaryNameFromFundingPlanInstructionAsync, getRequestPrimaryNameInstructionAsync, getRevokeVaultInstructionAsync, getTransferInstruction, getVaultedTransferInstructionAsync, } from './generated/core/instructions/index.js';
+import { getApprovePrimaryNameInstructionAsync, getCloseExpiredRequestInstruction, getCreateVaultInstructionAsync, getExtendVaultInstructionAsync, getIncreaseVaultInstructionAsync, getReleaseVaultInstructionAsync, getRequestAndSetPrimaryNameFromFundingPlanInstructionAsync, getRequestPrimaryNameFromFundingPlanInstructionAsync, getRequestPrimaryNameInstructionAsync, getRevokeVaultInstructionAsync, getVaultedTransferInstructionAsync, } from './generated/core/instructions/index.js';
 import { getDelegationDecoder } from './generated/gar/accounts/delegation.js';
 import { getGatewayDecoder } from './generated/gar/accounts/gateway.js';
 import { getAllowDelegateInstructionAsync, getCancelWithdrawalInstruction, getClaimDelegateFromLeavingGatewayInstructionAsync, getClaimWithdrawalInstructionAsync, getCloseDrainedWithdrawalInstruction, getCloseEmptyDelegationInstruction, getCloseEpochInstructionAsync, getCloseObservationInstructionAsync, getCreateEpochInstructionAsync, getDecreaseDelegateStakeInstructionAsync, getDecreaseOperatorStakeInstructionAsync, getDelegateStakeInstructionAsync, getDisallowDelegateInstructionAsync, getDistributeEpochInstructionAsync, getFinalizeGoneInstructionAsync, getIncreaseOperatorStakeInstructionAsync, getInstantWithdrawalInstructionAsync, getJoinNetworkInstructionAsync, getLeaveNetworkInstructionAsync, getPrescribeEpochInstructionAsync, getPruneGatewayInstructionAsync, getRedelegateStakeInstructionAsync, getSaveObservationsInstructionAsync, getSetAllowlistEnabledInstructionAsync, getTallyWeightsInstructionAsync, getUpdateGatewaySettingsInstructionAsync, } from './generated/gar/instructions/index.js';
@@ -240,18 +242,25 @@ export class SolanaARIOWriteable extends SolanaARIOReadable {
         const mint = await this.getMint();
         const fromATA = await getAssociatedTokenAddressKit(mint, this.signer.address);
         const toATA = await getAssociatedTokenAddressKit(mint, recipient);
-        // The on-chain `Transfer` ix requires `to_token_account` to exist as a
-        // valid SPL TokenAccount (`AccountNotInitialized` #3012 otherwise).
-        // Bundle an idempotent CreateAssociatedTokenAccount so a fresh recipient
-        // wallet just works — same pattern as `vaultedTransfer` below. Idempotent
-        // means a second transfer to the same recipient is a no-op for this ix.
+        // SPL `transferChecked` requires the recipient ATA to exist; bundle
+        // an idempotent ATA-create so fresh recipients just work. Same
+        // pattern as `vaultedTransfer` below.
         const createToAtaIx = buildCreateAtaIdempotentIx(this.signer.address, toATA, recipient, mint);
-        const ix = getTransferInstruction({
-            fromTokenAccount: fromATA,
-            toTokenAccount: toATA,
+        // Standard SPL Token `transferChecked`. The custom `ario-core::transfer`
+        // ix is deprecated — it added no protocol-level accounting, just wrapped
+        // this same CPI plus a `TransferEvent` emission that no major Solana
+        // indexer needs (Helius, Solscan, etc. all track SPL transfers natively).
+        // See `docs/REMOVE_CUSTOM_TRANSFER_PLAN.md` in `ar-io/solana-ar-io`.
+        // `transferChecked` (vs `transfer`) validates the mint + decimals
+        // on-chain, preventing cross-mint mistakes.
+        const ix = getTransferCheckedInstruction({
+            source: fromATA,
+            mint,
+            destination: toATA,
             authority: this.signer,
             amount,
-        }, { programAddress: this.coreProgram });
+            decimals: TOKEN_DECIMALS,
+        });
         const sig = await this.sendTransaction([createToAtaIx, ix]);
         return { id: sig };
     }

package/lib/esm/version.js

@@ -14,4 +14,4 @@
  * limitations under the License.
  */
 // AUTOMATICALLY GENERATED FILE - DO NOT TOUCH
-export const version = '4.0.0-solana.4';
+export const version = '4.0.0-solana.5';

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.3";
+export declare const version = "4.0.0-solana.4";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ar.io/sdk",
-  "version": "4.0.0-solana.4",
+  "version": "4.0.0-solana.5",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ar-io/ar-io-sdk.git"
@@ -9,6 +9,7 @@
   "module": "./lib/esm/node/index.js",
   "types": "./lib/types/node/index.d.ts",
   "type": "module",
+  "packageManager": "yarn@1.22.22",
   "engines": {
     "node": ">=18"
   },
@@ -133,6 +134,7 @@
     "@dha-team/arbundles": "^1.0.1",
     "@permaweb/aoconnect": "0.0.68",
     "@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",