@ar.io/sdk 3.4.0-alpha.3 → 3.4.0

package/lib/cjs/cli/cli.js

@@ -283,6 +283,24 @@ const utils_js_1 = require("./utils.js");
     options: [...options_js_1.writeActionOptions, options_js_1.optionMap.vaultId, options_js_1.optionMap.recipient],
     action: transfer_js_1.revokeVaultCLICommand,
 });
+(0, utils_js_1.makeCommand)({
+    name: 'create-vault',
+    description: 'Create a locked vault with balance from the sender',
+    options: [...options_js_1.writeActionOptions, options_js_1.optionMap.lockLengthMs, options_js_1.optionMap.quantity],
+    action: transfer_js_1.createVaultCLICommand,
+});
+(0, utils_js_1.makeCommand)({
+    name: 'extend-vault',
+    description: 'Extend the lock length of a vault as the recipient',
+    options: [...options_js_1.writeActionOptions, options_js_1.optionMap.vaultId, options_js_1.optionMap.extendLengthMs],
+    action: transfer_js_1.extendVaultCLICommand,
+});
+(0, utils_js_1.makeCommand)({
+    name: 'increase-vault',
+    description: 'Increase the balance of a locked vault as the recipient',
+    options: [...options_js_1.writeActionOptions, options_js_1.optionMap.vaultId, options_js_1.optionMap.quantity],
+    action: transfer_js_1.increaseVaultCLICommand,
+});
 (0, utils_js_1.makeCommand)({
     name: 'join-network',
     description: 'Join a gateway to the AR.IO network',

package/lib/cjs/cli/commands/transfer.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.revokeVaultCLICommand = exports.vaultedTransferCLICommand = exports.transferCLICommand = void 0;
+exports.increaseVaultCLICommand = exports.extendVaultCLICommand = exports.createVaultCLICommand = exports.revokeVaultCLICommand = exports.vaultedTransferCLICommand = exports.transferCLICommand = void 0;
 const utils_js_1 = require("../utils.js");
 async function transferCLICommand(options) {
     const { target, arioQuantity } = (0, utils_js_1.requiredTargetAndQuantityFromOptions)(options);
@@ -33,6 +33,7 @@ async function vaultedTransferCLICommand(o) {
     const recipient = (0, utils_js_1.requiredStringFromOptions)(o, 'recipient');
     const { ario, signerAddress } = (0, utils_js_1.writeARIOFromOptions)(o);
     const lockLengthMs = (0, utils_js_1.requiredPositiveIntegerFromOptions)(o, 'lockLengthMs');
+    (0, utils_js_1.assertLockLengthInRange)(lockLengthMs);
     if (!o.skipConfirmation) {
         await (0, utils_js_1.assertEnoughMARIOBalance)({
             ario,
@@ -84,3 +85,84 @@ async function revokeVaultCLICommand(o) {
     return output;
 }
 exports.revokeVaultCLICommand = revokeVaultCLICommand;
+async function createVaultCLICommand(o) {
+    const mARIOQuantity = (0, utils_js_1.requiredMARIOFromOptions)(o, 'quantity');
+    const { ario, signerAddress } = (0, utils_js_1.writeARIOFromOptions)(o);
+    const lockLengthMs = (0, utils_js_1.requiredPositiveIntegerFromOptions)(o, 'lockLengthMs');
+    (0, utils_js_1.assertLockLengthInRange)(lockLengthMs);
+    if (!o.skipConfirmation) {
+        await (0, utils_js_1.assertEnoughMARIOBalance)({
+            ario,
+            address: signerAddress,
+            mARIOQuantity,
+        });
+        const confirm = await (0, utils_js_1.confirmationPrompt)(`Are you sure you want to create a vault with ${(0, utils_js_1.formatMARIOToARIOWithCommas)(mARIOQuantity)} ARIO, locked for ${lockLengthMs}ms?`);
+        if (!confirm) {
+            return { message: 'Vault creation aborted by user' };
+        }
+    }
+    const result = await ario.createVault({
+        quantity: mARIOQuantity,
+        lockLengthMs,
+    }, (0, utils_js_1.writeActionTagsFromOptions)(o));
+    const output = {
+        senderAddress: signerAddress,
+        transferResult: result,
+        message: `Successfully created vault with ${(0, utils_js_1.formatMARIOToARIOWithCommas)(mARIOQuantity)} ARIO`,
+    };
+    return output;
+}
+exports.createVaultCLICommand = createVaultCLICommand;
+async function extendVaultCLICommand(o) {
+    const { ario, signerAddress } = (0, utils_js_1.writeARIOFromOptions)(o);
+    const vaultId = (0, utils_js_1.requiredStringFromOptions)(o, 'vaultId');
+    const extendLengthMs = (0, utils_js_1.requiredPositiveIntegerFromOptions)(o, 'extendLengthMs');
+    (0, utils_js_1.assertLockLengthInRange)(extendLengthMs, false);
+    if (!o.skipConfirmation) {
+        const vault = await ario.getVault({ vaultId, address: signerAddress });
+        if (!vault) {
+            throw new Error(`Vault for signer '${signerAddress}' with vault id '${vaultId}' not found`);
+        }
+        const confirm = await (0, utils_js_1.confirmationPrompt)(`Are you sure you want to extend vault with id ${vaultId} for ${extendLengthMs}ms?`);
+        if (!confirm) {
+            return { message: 'Vault extension aborted by user' };
+        }
+    }
+    const result = await ario.extendVault({
+        vaultId,
+        extendLengthMs,
+    }, (0, utils_js_1.writeActionTagsFromOptions)(o));
+    const output = {
+        senderAddress: signerAddress,
+        transferResult: result,
+        message: `Successfully extended vault with id ${vaultId}`,
+    };
+    return output;
+}
+exports.extendVaultCLICommand = extendVaultCLICommand;
+async function increaseVaultCLICommand(o) {
+    const mARIOQuantity = (0, utils_js_1.requiredMARIOFromOptions)(o, 'quantity');
+    const { ario, signerAddress } = (0, utils_js_1.writeARIOFromOptions)(o);
+    const vaultId = (0, utils_js_1.requiredStringFromOptions)(o, 'vaultId');
+    if (!o.skipConfirmation) {
+        const vault = await ario.getVault({ vaultId, address: signerAddress });
+        if (!vault) {
+            throw new Error(`Vault for signer '${signerAddress}' with vault id '${vaultId}' not found`);
+        }
+        const confirm = await (0, utils_js_1.confirmationPrompt)(`Are you sure you want to increase vault with id ${vaultId} by ${(0, utils_js_1.formatMARIOToARIOWithCommas)(mARIOQuantity)} ARIO?`);
+        if (!confirm) {
+            return { message: 'Vault increase aborted by user' };
+        }
+    }
+    const result = await ario.increaseVault({
+        vaultId,
+        quantity: mARIOQuantity,
+    }, (0, utils_js_1.writeActionTagsFromOptions)(o));
+    const output = {
+        senderAddress: signerAddress,
+        transferResult: result,
+        message: `Successfully increased vault with id ${vaultId} by ${(0, utils_js_1.formatMARIOToARIOWithCommas)(mARIOQuantity)} ARIO`,
+    };
+    return output;
+}
+exports.increaseVaultCLICommand = increaseVaultCLICommand;

package/lib/cjs/cli/options.js

@@ -248,7 +248,11 @@ exports.optionMap = {
     },
     lockLengthMs: {
         alias: '--lock-length-ms <lockLengthMs>',
-        description: 'The length of time in milliseconds to lock the transfer for',
+        description: 'The length of time in milliseconds to lock the vault for',
+    },
+    extendLengthMs: {
+        alias: '--extend-length-ms <extendLengthMs>',
+        description: 'The length of time in milliseconds to extend the vault for',
     },
     recipient: {
         alias: '--recipient <recipient>',

package/lib/cjs/cli/utils.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fundFromFromOptions = exports.getTokenCostParamsFromOptions = exports.getANTStateFromOptions = exports.requiredPositiveIntegerFromOptions = exports.positiveIntegerFromOptions = exports.requiredStringArrayFromOptions = exports.requiredStringFromOptions = exports.booleanFromOptions = exports.writeANTFromOptions = exports.readANTFromOptions = exports.requiredProcessIdFromOptions = exports.assertConfirmationPrompt = exports.confirmationPrompt = exports.assertEnoughMARIOBalance = exports.assertEnoughBalanceForArNSPurchase = exports.requiredMARIOFromOptions = exports.recordTypeFromOptions = exports.redelegateParamsFromOptions = exports.requiredTargetAndQuantityFromOptions = exports.gatewaySettingsFromOptions = exports.writeActionTagsFromOptions = exports.requiredInitiatorFromOptions = exports.epochInputFromOptions = exports.paginationParamsFromOptions = exports.requiredAddressFromOptions = exports.addressFromOptions = exports.formatMARIOToARIOWithCommas = exports.formatARIOWithCommas = exports.writeARIOFromOptions = exports.requiredAoSignerFromOptions = exports.requiredContractSignerFromOptions = exports.readARIOFromOptions = exports.getLoggerFromOptions = exports.jwkToAddress = exports.requiredJwkFromOptions = exports.arioProcessIdFromOptions = exports.makeCommand = exports.applyOptions = exports.runCommand = exports.stringifyJsonForCLIDisplay = exports.defaultTtlSecondsCLI = void 0;
+exports.assertLockLengthInRange = exports.fundFromFromOptions = exports.getTokenCostParamsFromOptions = exports.getANTStateFromOptions = exports.requiredPositiveIntegerFromOptions = exports.positiveIntegerFromOptions = exports.requiredStringArrayFromOptions = exports.requiredStringFromOptions = exports.booleanFromOptions = exports.writeANTFromOptions = exports.readANTFromOptions = exports.requiredProcessIdFromOptions = exports.assertConfirmationPrompt = exports.confirmationPrompt = exports.assertEnoughMARIOBalance = exports.assertEnoughBalanceForArNSPurchase = exports.requiredMARIOFromOptions = exports.recordTypeFromOptions = exports.redelegateParamsFromOptions = exports.requiredTargetAndQuantityFromOptions = exports.gatewaySettingsFromOptions = exports.writeActionTagsFromOptions = exports.requiredInitiatorFromOptions = exports.epochInputFromOptions = exports.paginationParamsFromOptions = exports.requiredAddressFromOptions = exports.addressFromOptions = exports.formatMARIOToARIOWithCommas = exports.formatARIOWithCommas = exports.writeARIOFromOptions = exports.requiredAoSignerFromOptions = exports.requiredContractSignerFromOptions = exports.readARIOFromOptions = exports.getLoggerFromOptions = exports.jwkToAddress = exports.requiredJwkFromOptions = exports.arioProcessIdFromOptions = exports.makeCommand = exports.applyOptions = exports.runCommand = exports.stringifyJsonForCLIDisplay = exports.defaultTtlSecondsCLI = void 0;
 /**
  * Copyright (C) 2022-2024 Permanent Data Solutions, Inc.
  *
@@ -464,3 +464,17 @@ function fundFromFromOptions(o) {
     return o.fundFrom ?? 'balance';
 }
 exports.fundFromFromOptions = fundFromFromOptions;
+function assertLockLengthInRange(lockLengthMs, assertMin = true) {
+    const minLockLengthMs = 1209600000; // 14 days
+    const maxLockLengthMs = 378432000000; // ~12 years
+    if (lockLengthMs > maxLockLengthMs) {
+        throw new Error(`Lock length must be at most 12 years (378432000000 ms). Provided lock length: ${lockLengthMs} ms`);
+    }
+    if (!assertMin) {
+        return;
+    }
+    if (lockLengthMs < minLockLengthMs) {
+        throw new Error(`Lock length must be at least 14 days (1209600000 ms). Provided lock length: ${lockLengthMs} ms`);
+    }
+}
+exports.assertLockLengthInRange = assertLockLengthInRange;

package/lib/cjs/common/io.js

@@ -518,6 +518,42 @@ class ARIOWriteable extends ARIOReadable {
             signer: this.signer,
         });
     }
+    async createVault({ lockLengthMs, quantity }, options) {
+        const { tags = [] } = options || {};
+        return this.process.send({
+            tags: [
+                ...tags,
+                { name: 'Action', value: 'Create-Vault' },
+                { name: 'Lock-Length', value: lockLengthMs.toString() },
+                { name: 'Quantity', value: quantity.toString() },
+            ],
+            signer: this.signer,
+        });
+    }
+    async extendVault({ vaultId, extendLengthMs }, options) {
+        const { tags = [] } = options || {};
+        return this.process.send({
+            tags: [
+                ...tags,
+                { name: 'Action', value: 'Extend-Vault' },
+                { name: 'Vault-Id', value: vaultId },
+                { name: 'Extend-Length', value: extendLengthMs.toString() },
+            ],
+            signer: this.signer,
+        });
+    }
+    async increaseVault({ vaultId, quantity }, options) {
+        const { tags = [] } = options || {};
+        return this.process.send({
+            tags: [
+                ...tags,
+                { name: 'Action', value: 'Increase-Vault' },
+                { name: 'Vault-Id', value: vaultId },
+                { name: 'Quantity', value: quantity.toString() },
+            ],
+            signer: this.signer,
+        });
+    }
     async joinNetwork({ operatorStake, allowDelegatedStaking, allowedDelegates, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, port, properties, protocol, autoStake, observerAddress, }, options) {
         const { tags = [] } = options || {};
         const allTags = [

package/lib/cjs/types/io.js

@@ -24,7 +24,7 @@ const isValidFundFrom = (fundFrom) => {
     return exports.fundFromOptions.indexOf(fundFrom) !== -1;
 };
 exports.isValidFundFrom = isValidFundFrom;
-// Typeguard functions
+// Type-guard functions
 function isProcessConfiguration(config) {
     return 'process' in config;
 }

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 = '3.4.0-alpha.3';
+exports.version = '3.4.0';

package/lib/esm/cli/cli.js

@@ -23,7 +23,7 @@ import { setAntBaseNameCLICommand, setAntRecordCLICommand, } from './commands/an
 import { buyRecordCLICommand, extendLeaseCLICommand, increaseUndernameLimitCLICommand, requestPrimaryNameCLICommand, upgradeRecordCLICommand, } from './commands/arnsPurchaseCommands.js';
 import { cancelWithdrawal, decreaseDelegateStake, decreaseOperatorStake, delegateStake, increaseOperatorStake, instantWithdrawal, joinNetwork, leaveNetwork, redelegateStake, saveObservations, updateGatewaySettings, } from './commands/gatewayWriteCommands.js';
 import { getAllGatewayVaults, getAllowedDelegates, getArNSRecord, getArNSReservedName, getArNSReturnedName, getCostDetails, getDelegations, getEpoch, getGateway, getGatewayDelegates, getGatewayVaults, getPrescribedNames, getPrescribedObservers, getPrimaryName, getTokenCost, getVault, listAllDelegatesCLICommand, listArNSRecords, listArNSReservedNames, listArNSReturnedNames, listGateways, } from './commands/readCommands.js';
-import { revokeVaultCLICommand, transferCLICommand, vaultedTransferCLICommand, } from './commands/transfer.js';
+import { createVaultCLICommand, extendVaultCLICommand, increaseVaultCLICommand, revokeVaultCLICommand, transferCLICommand, vaultedTransferCLICommand, } from './commands/transfer.js';
 import { addressAndVaultIdOptions, antStateOptions, arnsPurchaseOptions, buyRecordOptions, decreaseDelegateStakeOptions, delegateStakeOptions, epochOptions, getVaultOptions, globalOptions, joinNetworkOptions, operatorStakeOptions, optionMap, paginationAddressOptions, paginationOptions, redelegateStakeOptions, setAntBaseNameOptions, setAntUndernameOptions, tokenCostOptions, transferOptions, updateGatewaySettingsOptions, vaultedTransferOptions, writeActionOptions, } from './options.js';
 import { applyOptions, arioProcessIdFromOptions, assertConfirmationPrompt, epochInputFromOptions, formatARIOWithCommas, getANTStateFromOptions, getLoggerFromOptions, makeCommand, paginationParamsFromOptions, readANTFromOptions, readARIOFromOptions, requiredAddressFromOptions, requiredAoSignerFromOptions, requiredProcessIdFromOptions, requiredStringArrayFromOptions, requiredStringFromOptions, writeANTFromOptions, writeActionTagsFromOptions, } from './utils.js';
 applyOptions(program
@@ -281,6 +281,24 @@ makeCommand({
     options: [...writeActionOptions, optionMap.vaultId, optionMap.recipient],
     action: revokeVaultCLICommand,
 });
+makeCommand({
+    name: 'create-vault',
+    description: 'Create a locked vault with balance from the sender',
+    options: [...writeActionOptions, optionMap.lockLengthMs, optionMap.quantity],
+    action: createVaultCLICommand,
+});
+makeCommand({
+    name: 'extend-vault',
+    description: 'Extend the lock length of a vault as the recipient',
+    options: [...writeActionOptions, optionMap.vaultId, optionMap.extendLengthMs],
+    action: extendVaultCLICommand,
+});
+makeCommand({
+    name: 'increase-vault',
+    description: 'Increase the balance of a locked vault as the recipient',
+    options: [...writeActionOptions, optionMap.vaultId, optionMap.quantity],
+    action: increaseVaultCLICommand,
+});
 makeCommand({
     name: 'join-network',
     description: 'Join a gateway to the AR.IO network',

package/lib/esm/cli/commands/transfer.js

@@ -1,4 +1,4 @@
-import { assertEnoughMARIOBalance, confirmationPrompt, formatARIOWithCommas, formatMARIOToARIOWithCommas, requiredMARIOFromOptions, requiredPositiveIntegerFromOptions, requiredStringFromOptions, requiredTargetAndQuantityFromOptions, writeARIOFromOptions, writeActionTagsFromOptions, } from '../utils.js';
+import { assertEnoughMARIOBalance, assertLockLengthInRange, confirmationPrompt, formatARIOWithCommas, formatMARIOToARIOWithCommas, requiredMARIOFromOptions, requiredPositiveIntegerFromOptions, requiredStringFromOptions, requiredTargetAndQuantityFromOptions, writeARIOFromOptions, writeActionTagsFromOptions, } from '../utils.js';
 export async function transferCLICommand(options) {
     const { target, arioQuantity } = requiredTargetAndQuantityFromOptions(options);
     const { ario, signerAddress } = writeARIOFromOptions(options);
@@ -29,6 +29,7 @@ export async function vaultedTransferCLICommand(o) {
     const recipient = requiredStringFromOptions(o, 'recipient');
     const { ario, signerAddress } = writeARIOFromOptions(o);
     const lockLengthMs = requiredPositiveIntegerFromOptions(o, 'lockLengthMs');
+    assertLockLengthInRange(lockLengthMs);
     if (!o.skipConfirmation) {
         await assertEnoughMARIOBalance({
             ario,
@@ -78,3 +79,81 @@ export async function revokeVaultCLICommand(o) {
     };
     return output;
 }
+export async function createVaultCLICommand(o) {
+    const mARIOQuantity = requiredMARIOFromOptions(o, 'quantity');
+    const { ario, signerAddress } = writeARIOFromOptions(o);
+    const lockLengthMs = requiredPositiveIntegerFromOptions(o, 'lockLengthMs');
+    assertLockLengthInRange(lockLengthMs);
+    if (!o.skipConfirmation) {
+        await assertEnoughMARIOBalance({
+            ario,
+            address: signerAddress,
+            mARIOQuantity,
+        });
+        const confirm = await confirmationPrompt(`Are you sure you want to create a vault with ${formatMARIOToARIOWithCommas(mARIOQuantity)} ARIO, locked for ${lockLengthMs}ms?`);
+        if (!confirm) {
+            return { message: 'Vault creation aborted by user' };
+        }
+    }
+    const result = await ario.createVault({
+        quantity: mARIOQuantity,
+        lockLengthMs,
+    }, writeActionTagsFromOptions(o));
+    const output = {
+        senderAddress: signerAddress,
+        transferResult: result,
+        message: `Successfully created vault with ${formatMARIOToARIOWithCommas(mARIOQuantity)} ARIO`,
+    };
+    return output;
+}
+export async function extendVaultCLICommand(o) {
+    const { ario, signerAddress } = writeARIOFromOptions(o);
+    const vaultId = requiredStringFromOptions(o, 'vaultId');
+    const extendLengthMs = requiredPositiveIntegerFromOptions(o, 'extendLengthMs');
+    assertLockLengthInRange(extendLengthMs, false);
+    if (!o.skipConfirmation) {
+        const vault = await ario.getVault({ vaultId, address: signerAddress });
+        if (!vault) {
+            throw new Error(`Vault for signer '${signerAddress}' with vault id '${vaultId}' not found`);
+        }
+        const confirm = await confirmationPrompt(`Are you sure you want to extend vault with id ${vaultId} for ${extendLengthMs}ms?`);
+        if (!confirm) {
+            return { message: 'Vault extension aborted by user' };
+        }
+    }
+    const result = await ario.extendVault({
+        vaultId,
+        extendLengthMs,
+    }, writeActionTagsFromOptions(o));
+    const output = {
+        senderAddress: signerAddress,
+        transferResult: result,
+        message: `Successfully extended vault with id ${vaultId}`,
+    };
+    return output;
+}
+export async function increaseVaultCLICommand(o) {
+    const mARIOQuantity = requiredMARIOFromOptions(o, 'quantity');
+    const { ario, signerAddress } = writeARIOFromOptions(o);
+    const vaultId = requiredStringFromOptions(o, 'vaultId');
+    if (!o.skipConfirmation) {
+        const vault = await ario.getVault({ vaultId, address: signerAddress });
+        if (!vault) {
+            throw new Error(`Vault for signer '${signerAddress}' with vault id '${vaultId}' not found`);
+        }
+        const confirm = await confirmationPrompt(`Are you sure you want to increase vault with id ${vaultId} by ${formatMARIOToARIOWithCommas(mARIOQuantity)} ARIO?`);
+        if (!confirm) {
+            return { message: 'Vault increase aborted by user' };
+        }
+    }
+    const result = await ario.increaseVault({
+        vaultId,
+        quantity: mARIOQuantity,
+    }, writeActionTagsFromOptions(o));
+    const output = {
+        senderAddress: signerAddress,
+        transferResult: result,
+        message: `Successfully increased vault with id ${vaultId} by ${formatMARIOToARIOWithCommas(mARIOQuantity)} ARIO`,
+    };
+    return output;
+}

package/lib/esm/cli/options.js

@@ -245,7 +245,11 @@ export const optionMap = {
     },
     lockLengthMs: {
         alias: '--lock-length-ms <lockLengthMs>',
-        description: 'The length of time in milliseconds to lock the transfer for',
+        description: 'The length of time in milliseconds to lock the vault for',
+    },
+    extendLengthMs: {
+        alias: '--extend-length-ms <extendLengthMs>',
+        description: 'The length of time in milliseconds to extend the vault for',
     },
     recipient: {
         alias: '--recipient <recipient>',

package/lib/esm/cli/utils.js

@@ -418,3 +418,16 @@ export function fundFromFromOptions(o) {
     }
     return o.fundFrom ?? 'balance';
 }
+export function assertLockLengthInRange(lockLengthMs, assertMin = true) {
+    const minLockLengthMs = 1209600000; // 14 days
+    const maxLockLengthMs = 378432000000; // ~12 years
+    if (lockLengthMs > maxLockLengthMs) {
+        throw new Error(`Lock length must be at most 12 years (378432000000 ms). Provided lock length: ${lockLengthMs} ms`);
+    }
+    if (!assertMin) {
+        return;
+    }
+    if (lockLengthMs < minLockLengthMs) {
+        throw new Error(`Lock length must be at least 14 days (1209600000 ms). Provided lock length: ${lockLengthMs} ms`);
+    }
+}

package/lib/esm/common/io.js

@@ -513,6 +513,42 @@ export class ARIOWriteable extends ARIOReadable {
             signer: this.signer,
         });
     }
+    async createVault({ lockLengthMs, quantity }, options) {
+        const { tags = [] } = options || {};
+        return this.process.send({
+            tags: [
+                ...tags,
+                { name: 'Action', value: 'Create-Vault' },
+                { name: 'Lock-Length', value: lockLengthMs.toString() },
+                { name: 'Quantity', value: quantity.toString() },
+            ],
+            signer: this.signer,
+        });
+    }
+    async extendVault({ vaultId, extendLengthMs }, options) {
+        const { tags = [] } = options || {};
+        return this.process.send({
+            tags: [
+                ...tags,
+                { name: 'Action', value: 'Extend-Vault' },
+                { name: 'Vault-Id', value: vaultId },
+                { name: 'Extend-Length', value: extendLengthMs.toString() },
+            ],
+            signer: this.signer,
+        });
+    }
+    async increaseVault({ vaultId, quantity }, options) {
+        const { tags = [] } = options || {};
+        return this.process.send({
+            tags: [
+                ...tags,
+                { name: 'Action', value: 'Increase-Vault' },
+                { name: 'Vault-Id', value: vaultId },
+                { name: 'Quantity', value: quantity.toString() },
+            ],
+            signer: this.signer,
+        });
+    }
     async joinNetwork({ operatorStake, allowDelegatedStaking, allowedDelegates, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, port, properties, protocol, autoStake, observerAddress, }, options) {
         const { tags = [] } = options || {};
         const allTags = [

package/lib/esm/types/io.js

@@ -19,7 +19,7 @@ export const fundFromOptions = ['balance', 'stakes', 'any'];
 export const isValidFundFrom = (fundFrom) => {
     return fundFromOptions.indexOf(fundFrom) !== -1;
 };
-// Typeguard functions
+// Type-guard functions
 export function isProcessConfiguration(config) {
     return 'process' in config;
 }

package/lib/esm/version.js

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

package/lib/types/cli/commands/transfer.d.ts

@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { AoRevokeVaultParams, AoVaultedTransferParams } from '../../types/io.js';
+import { AoCreateVaultParams, AoExtendVaultParams, AoIncreaseVaultParams, AoRevokeVaultParams, AoVaultedTransferParams } from '../../types/io.js';
 import { CLIWriteOptionsFromAoParams, JsonSerializable, TransferCLIOptions } from '../types.js';
 export declare function transferCLICommand(options: TransferCLIOptions): Promise<{
     senderAddress: string;
@@ -24,3 +24,18 @@ export declare function transferCLICommand(options: TransferCLIOptions): Promise
 }>;
 export declare function vaultedTransferCLICommand(o: CLIWriteOptionsFromAoParams<AoVaultedTransferParams>): Promise<JsonSerializable>;
 export declare function revokeVaultCLICommand(o: CLIWriteOptionsFromAoParams<AoRevokeVaultParams>): Promise<JsonSerializable>;
+export declare function createVaultCLICommand(o: CLIWriteOptionsFromAoParams<AoCreateVaultParams>): Promise<JsonSerializable>;
+export declare function extendVaultCLICommand(o: CLIWriteOptionsFromAoParams<AoExtendVaultParams>): Promise<{
+    senderAddress: string;
+    transferResult: import("../../types/common.js").AoMessageResult;
+    message: string;
+} | {
+    message: string;
+}>;
+export declare function increaseVaultCLICommand(o: CLIWriteOptionsFromAoParams<AoIncreaseVaultParams>): Promise<{
+    senderAddress: string;
+    transferResult: import("../../types/common.js").AoMessageResult;
+    message: string;
+} | {
+    message: string;
+}>;

package/lib/types/cli/options.d.ts

@@ -243,6 +243,10 @@ export declare const optionMap: {
         alias: string;
         description: string;
     };
+    extendLengthMs: {
+        alias: string;
+        description: string;
+    };
     recipient: {
         alias: string;
         description: string;

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

@@ -86,3 +86,4 @@ export declare function getTokenCostParamsFromOptions(o: GetTokenCostCLIOptions)
 export declare function fundFromFromOptions<O extends {
     fundFrom?: string;
 }>(o: O): FundFrom;
+export declare function assertLockLengthInRange(lockLengthMs: number, assertMin?: boolean): void;

package/lib/types/common/io.d.ts

@@ -15,7 +15,7 @@
  */
 import Arweave from 'arweave';
 import { AoArNSNameDataWithName, AoArNSReservedNameData, AoBalanceWithAddress, AoEpochDistributionData, AoEpochObservationData, AoGatewayWithAddress, AoJoinNetworkParams, AoMessageResult, AoPrimaryName, AoPrimaryNameRequest, AoRedelegationFeeInfo, AoReturnedName, AoTokenSupplyData, AoUpdateGatewaySettingsParams, AoWeightedObserver, OptionalArweave, PaginationParams, PaginationResult, ProcessConfiguration, TransactionId, WalletAddress, WithSigner, WriteOptions } from '../types/index.js';
-import { AoARIORead, AoARIOWrite, AoAllDelegates, AoAllGatewayVaults, AoArNSNameData, AoArNSPurchaseParams, AoArNSReservedNameDataWithName, AoBuyRecordParams, AoDelegation, AoEpochData, AoEpochSettings, AoExtendLeaseParams, AoGateway, AoGatewayDelegateWithAddress, AoGatewayRegistrySettings, AoGatewayVault, AoGetCostDetailsParams, AoIncreaseUndernameLimitParams, AoPaginatedAddressParams, AoRegistrationFees, AoRevokeVaultParams, AoVaultData, AoVaultedTransferParams, AoWalletVault, CostDetailsResult, DemandFactorSettings, EpochInput } from '../types/io.js';
+import { AoARIORead, AoARIOWrite, AoAllDelegates, AoAllGatewayVaults, AoArNSNameData, AoArNSPurchaseParams, AoArNSReservedNameDataWithName, AoBuyRecordParams, AoCreateVaultParams, AoDelegation, AoEpochData, AoEpochSettings, AoExtendLeaseParams, AoExtendVaultParams, AoGateway, AoGatewayDelegateWithAddress, AoGatewayRegistrySettings, AoGatewayVault, AoGetCostDetailsParams, AoIncreaseUndernameLimitParams, AoIncreaseVaultParams, AoPaginatedAddressParams, AoRegistrationFees, AoRevokeVaultParams, AoVaultData, AoVaultedTransferParams, AoWalletVault, CostDetailsResult, DemandFactorSettings, EpochInput } from '../types/io.js';
 import { mARIOToken } from '../types/token.js';
 import { AOProcess } from './contracts/ao-process.js';
 type ARIOConfigNoSigner = OptionalArweave<ProcessConfiguration>;
@@ -149,6 +149,9 @@ export declare class ARIOWriteable extends ARIOReadable implements AoARIOWrite {
     }, options?: WriteOptions): Promise<AoMessageResult>;
     vaultedTransfer({ recipient, quantity, lockLengthMs, revokable, }: AoVaultedTransferParams, options?: WriteOptions): Promise<AoMessageResult>;
     revokeVault({ vaultId, recipient }: AoRevokeVaultParams, options?: WriteOptions): Promise<AoMessageResult>;
+    createVault({ lockLengthMs, quantity }: AoCreateVaultParams, options?: WriteOptions): Promise<AoMessageResult>;
+    extendVault({ vaultId, extendLengthMs }: AoExtendVaultParams, options?: WriteOptions): Promise<AoMessageResult>;
+    increaseVault({ vaultId, quantity }: AoIncreaseVaultParams, options?: WriteOptions): Promise<AoMessageResult>;
     joinNetwork({ operatorStake, allowDelegatedStaking, allowedDelegates, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, port, properties, protocol, autoStake, observerAddress, }: AoJoinNetworkParams, options?: WriteOptions): Promise<AoMessageResult>;
     leaveNetwork(options?: WriteOptions): Promise<AoMessageResult>;
     updateGatewaySettings({ allowDelegatedStaking, allowedDelegates, delegateRewardShareRatio, fqdn, label, minDelegatedStake, note, port, properties, protocol, autoStake, observerAddress, }: AoUpdateGatewaySettingsParams, options?: WriteOptions): Promise<AoMessageResult>;

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

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import { z } from 'zod';
-import { AoMessageResult, WalletAddress, WriteOptions } from './common.js';
+import { AoWriteAction, WalletAddress } from './common.js';
 /**
  * example error:
  *  {
@@ -180,62 +180,60 @@ export interface AoANTRead {
     getHandlers(): Promise<AoANTHandler[]>;
 }
 export interface AoANTWrite extends AoANTRead {
-    transfer: WriteAction<{
+    transfer: AoWriteAction<{
         target: WalletAddress;
     }>;
-    addController: WriteAction<{
+    addController: AoWriteAction<{
         controller: WalletAddress;
     }>;
-    removeController: WriteAction<{
+    removeController: AoWriteAction<{
         controller: WalletAddress;
     }>;
     /** @deprecated Use setUndernameRecord instead for undernames, and setBaseNameRecord instead for the top level name (e.g. "@") */
-    setRecord: WriteAction<AoANTSetUndernameRecordParams>;
-    removeRecord: WriteAction<{
+    setRecord: AoWriteAction<AoANTSetUndernameRecordParams>;
+    removeRecord: AoWriteAction<{
         undername: string;
     }>;
-    setBaseNameRecord: WriteAction<AoANTSetBaseNameRecordParams>;
-    setUndernameRecord: WriteAction<AoANTSetUndernameRecordParams>;
-    removeUndernameRecord: WriteAction<{
+    setBaseNameRecord: AoWriteAction<AoANTSetBaseNameRecordParams>;
+    setUndernameRecord: AoWriteAction<AoANTSetUndernameRecordParams>;
+    removeUndernameRecord: AoWriteAction<{
         undername: string;
     }>;
-    setTicker: WriteAction<{
+    setTicker: AoWriteAction<{
         ticker: string;
     }>;
-    setDescription: WriteAction<{
+    setDescription: AoWriteAction<{
         description: string;
     }>;
-    setKeywords: WriteAction<{
+    setKeywords: AoWriteAction<{
         keywords: string[];
     }>;
-    setName: WriteAction<{
+    setName: AoWriteAction<{
         name: string;
     }>;
-    setLogo: WriteAction<{
+    setLogo: AoWriteAction<{
         txId: string;
     }>;
-    releaseName: WriteAction<{
+    releaseName: AoWriteAction<{
         name: string;
         arioProcessId: string;
     }>;
-    reassignName: WriteAction<{
+    reassignName: AoWriteAction<{
         name: string;
         arioProcessId: string;
         antProcessId: string;
     }>;
-    approvePrimaryNameRequest: WriteAction<{
+    approvePrimaryNameRequest: AoWriteAction<{
         name: string;
         address: string;
         arioProcessId: string;
     }>;
-    removePrimaryNames: WriteAction<{
+    removePrimaryNames: AoWriteAction<{
         names: string[];
         arioProcessId: string;
         notifyOwners?: boolean;
     }>;
 }
-/** utility type to ensure WriteOptions are appended to each parameter set */
-type WriteAction<P, R = AoMessageResult> = (params: P, options?: WriteOptions) => Promise<R>;
 export type AoANTSetBaseNameRecordParams = {
     transactionId: string;
     ttlSeconds: number;
@@ -243,4 +241,3 @@ export type AoANTSetBaseNameRecordParams = {
 export type AoANTSetUndernameRecordParams = AoANTSetBaseNameRecordParams & {
     undername: string;
 };
-export {};

package/lib/types/types/common.d.ts

@@ -111,3 +111,5 @@ export interface AOContract {
         result?: K;
     }>;
 }
+/** utility type to ensure WriteOptions are appended to each parameter set */
+export type AoWriteAction<P, R = AoMessageResult> = (params: P, options?: WriteOptions) => Promise<R>;