@algorandfoundation/algokit-utils 6.2.1 → 7.0.0-alpha.1

package/src/app.mjs

@@ -0,0 +1,329 @@
+import algosdk from 'algosdk';
+import { legacySendAppTransactionBridge, _getAppArgsForABICall, _getBoxReference } from './transaction/legacy-bridge.mjs';
+import { getSenderAddress, encodeLease } from './transaction/transaction.mjs';
+import { AppManager } from '../types/app-manager.mjs';
+import { toNumber } from './util.mjs';
+
+var ABIMethod = algosdk.ABIMethod;
+var OnApplicationComplete = algosdk.OnApplicationComplete;
+/**
+ * @deprecated Use `algorand.send.appCreate()` / `algorand.createTransaction.appCreate()` / `algorand.send.appCreateMethodCall()`
+ * / `algorand.createTransaction.appCreateMethodCall()` instead
+ *
+ * Creates a smart contract app, returns the details of the created app.
+ * @param create The parameters to create the app with
+ * @param algod An algod client
+ * @returns The details of the created app, or the transaction to create it if `skipSending` and the compilation result
+ */
+async function createApp(create, algod) {
+    const onComplete = getAppOnCompleteAction(create.onCompleteAction);
+    if (onComplete === algosdk.OnApplicationComplete.ClearStateOC) {
+        throw new Error('Cannot create an app with on-complete action of ClearState');
+    }
+    const result = create.args?.method
+        ? await legacySendAppTransactionBridge(algod, create.from, create.args, create, {
+            sender: getSenderAddress(create.from),
+            onComplete,
+            approvalProgram: create.approvalProgram,
+            clearStateProgram: create.clearStateProgram,
+            method: create.args.method instanceof ABIMethod ? create.args.method : new ABIMethod(create.args.method),
+            extraProgramPages: create.schema.extraPages,
+            schema: create.schema,
+        }, (c) => c.appCreateMethodCall, (c) => c.appCreateMethodCall)
+        : await legacySendAppTransactionBridge(algod, create.from, create.args, create, {
+            sender: getSenderAddress(create.from),
+            onComplete,
+            approvalProgram: create.approvalProgram,
+            clearStateProgram: create.clearStateProgram,
+            extraProgramPages: create.schema.extraPages,
+            schema: create.schema,
+        }, (c) => c.appCreate, (c) => c.appCreate);
+    return {
+        ...result,
+        appId: 'appId' in result ? Number(result.appId) : 0,
+        appAddress: 'appAddress' in result ? result.appAddress.toString() : '',
+    };
+}
+/**
+ * @deprecated Use `algorand.send.appUpdate()` / `algorand.createTransaction.appUpdate()` / `algorand.send.appUpdateMethodCall()`
+ * / `algorand.createTransaction.appUpdateMethodCall()` instead
+ *
+ * Updates a smart contract app.
+ * @param update The parameters to update the app with
+ * @param algod An algod client
+ * @returns The transaction send result and the compilation result
+ */
+async function updateApp(update, algod) {
+    return update.args?.method
+        ? await legacySendAppTransactionBridge(algod, update.from, update.args, update, {
+            appId: BigInt(update.appId),
+            sender: getSenderAddress(update.from),
+            onComplete: algosdk.OnApplicationComplete.UpdateApplicationOC,
+            approvalProgram: update.approvalProgram,
+            clearStateProgram: update.clearStateProgram,
+            method: update.args.method instanceof ABIMethod ? update.args.method : new ABIMethod(update.args.method),
+        }, (c) => c.appUpdateMethodCall, (c) => c.appUpdateMethodCall)
+        : await legacySendAppTransactionBridge(algod, update.from, update.args, update, {
+            appId: BigInt(update.appId),
+            sender: getSenderAddress(update.from),
+            onComplete: algosdk.OnApplicationComplete.UpdateApplicationOC,
+            approvalProgram: update.approvalProgram,
+            clearStateProgram: update.clearStateProgram,
+        }, (c) => c.appUpdate, (c) => c.appUpdate);
+}
+/**
+ * @deprecated Use `algosdk.OnApplicationComplete` directly instead.
+ *
+ * Returns a `algosdk.OnApplicationComplete` for the given onCompleteAction.
+ *
+ * If given `undefined` will return `OnApplicationComplete.NoOpOC`.
+ *
+ * If given an `AppCallType` will convert the string enum to the correct underlying `algosdk.OnApplicationComplete`.
+ *
+ * @param onCompletionAction The on completion action
+ * @returns The `algosdk.OnApplicationComplete`
+ */
+function getAppOnCompleteAction(onCompletionAction) {
+    switch (onCompletionAction) {
+        case undefined:
+        case 'no_op':
+        case OnApplicationComplete.NoOpOC:
+            return OnApplicationComplete.NoOpOC;
+        case 'opt_in':
+        case OnApplicationComplete.OptInOC:
+            return OnApplicationComplete.OptInOC;
+        case 'close_out':
+        case OnApplicationComplete.CloseOutOC:
+            return OnApplicationComplete.CloseOutOC;
+        case 'clear_state':
+        case OnApplicationComplete.ClearStateOC:
+            return OnApplicationComplete.ClearStateOC;
+        case 'update_application':
+        case OnApplicationComplete.UpdateApplicationOC:
+            return OnApplicationComplete.UpdateApplicationOC;
+        case 'delete_application':
+        case OnApplicationComplete.DeleteApplicationOC:
+            return OnApplicationComplete.DeleteApplicationOC;
+    }
+}
+/**
+ * @deprecated Use `algorand.send.appUpdate()` / `algorand.createTransaction.appUpdate()` / `algorand.send.appUpdateMethodCall()`
+ * / `algorand.createTransaction.appUpdateMethodCall()` instead
+ *
+ * Issues a call to a given app.
+ * @param call The call details.
+ * @param algod An algod client
+ * @returns The result of the call
+ */
+async function callApp(call, algod) {
+    const onComplete = getAppOnCompleteAction(call.callType);
+    if (onComplete === algosdk.OnApplicationComplete.UpdateApplicationOC) {
+        throw new Error('Cannot execute an app call with on-complete action of Update');
+    }
+    if (call.args?.method && onComplete === algosdk.OnApplicationComplete.ClearStateOC) {
+        throw new Error('Cannot execute an ABI method call with on-complete action of ClearState');
+    }
+    return call.args?.method
+        ? await legacySendAppTransactionBridge(algod, call.from, call.args, call, {
+            appId: BigInt(call.appId),
+            sender: getSenderAddress(call.from),
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            onComplete: onComplete,
+            method: call.args.method instanceof ABIMethod ? call.args.method : new ABIMethod(call.args.method),
+        }, (c) => c.appCallMethodCall, (c) => c.appCallMethodCall)
+        : await legacySendAppTransactionBridge(algod, call.from, call.args, call, {
+            appId: BigInt(call.appId),
+            sender: getSenderAddress(call.from),
+            onComplete,
+        }, (c) => c.appCall, (c) => c.appCall);
+}
+/**
+ * @deprecated Use `AppManager.getABIReturn` instead.
+ *
+ * Returns any ABI return values for the given app call arguments and transaction confirmation.
+ * @param args The arguments that were used for the call
+ * @param confirmation The transaction confirmation from algod
+ * @returns The return value for the method call
+ */
+function getABIReturn(args, confirmation) {
+    if (!args || !args.method) {
+        return undefined;
+    }
+    const method = 'txnCount' in args.method ? args.method : new ABIMethod(args.method);
+    return AppManager.getABIReturn(confirmation, method);
+}
+/**
+ * @deprecated Use `algorand.app.getGlobalState` instead.
+ *
+ * Returns the current global state values for the given app ID
+ * @param appId The ID of the app return global state for
+ * @param algod An algod client instance
+ * @returns The current global state
+ */
+async function getAppGlobalState(appId, algod) {
+    return await new AppManager(algod).getGlobalState(BigInt(appId));
+}
+/**
+ * @deprecated Use `algorand.app.getLocalState` instead.
+ *
+ * Returns the current global state values for the given app ID and account
+ * @param appId The ID of the app return global state for
+ * @param account Either the string address of an account or an account object for the account to get local state for the given app
+ * @param algod An algod client instance
+ * @returns The current local state for the given (app, account) combination
+ */
+async function getAppLocalState(appId, account, algod) {
+    return new AppManager(algod).getLocalState(BigInt(appId), getSenderAddress(account));
+}
+/**
+ * @deprecated Use `algorand.app.getBoxNames` instead.
+ * Returns the names of the boxes for the given app.
+ * @param appId The ID of the app return box names for
+ * @param algod An algod client instance
+ * @returns The current box names
+ */
+async function getAppBoxNames(appId, algod) {
+    return new AppManager(algod).getBoxNames(BigInt(appId));
+}
+/**
+ * @deprecated Use `algorand.app.getBoxValue` instead.
+ * Returns the value of the given box name for the given app.
+ * @param appId The ID of the app return box names for
+ * @param boxName The name of the box to return either as a string, binary array or `BoxName`
+ * @param algod An algod client instance
+ * @returns The current box value as a byte array
+ */
+async function getAppBoxValue(appId, boxName, algod) {
+    return new AppManager(algod).getBoxValue(BigInt(appId), typeof boxName !== 'string' && 'name' in boxName ? boxName.nameRaw : boxName);
+}
+/**
+ * @deprecated Use `algorand.app.getBoxValues` instead.
+ * Returns the value of the given box names for the given app.
+ * @param appId The ID of the app return box names for
+ * @param boxNames The names of the boxes to return either as a string, binary array or `BoxName`
+ * @param algod An algod client instance
+ * @returns The current box values as a byte array in the same order as the passed in box names
+ */
+async function getAppBoxValues(appId, boxNames, algod) {
+    return new AppManager(algod).getBoxValues(BigInt(appId), boxNames.map((b) => (typeof b !== 'string' && 'name' in b ? b.nameRaw : b)));
+}
+/**
+ * @deprecated Use `algorand.app.getBoxValueFromABIType` instead.
+ * Returns the value of the given box name for the given app decoded based on the given ABI type.
+ * @param request The parameters for the box value request
+ * @param algod An algod client instance
+ * @returns The current box value as an ABI value
+ */
+async function getAppBoxValueFromABIType(request, algod) {
+    return new AppManager(algod).getBoxValueFromABIType({
+        appId: BigInt(request.appId),
+        boxName: typeof request.boxName !== 'string' && 'name' in request.boxName ? request.boxName.nameRaw : request.boxName,
+        type: request.type,
+    });
+}
+/**
+ * @deprecated Use `algorand.app.getBoxValuesFromABIType` instead.
+ * Returns the value of the given box names for the given app decoded based on the given ABI type.
+ * @param request The parameters for the box value request
+ * @param algod An algod client instance
+ * @returns The current box values as an ABI value in the same order as the passed in box names
+ */
+async function getAppBoxValuesFromABIType(request, algod) {
+    return new AppManager(algod).getBoxValuesFromABIType({
+        appId: BigInt(request.appId),
+        boxNames: request.boxNames.map((b) => (typeof b !== 'string' && 'name' in b ? b.nameRaw : b)),
+        type: request.type,
+    });
+}
+/**
+ * @deprecated Use `AppManager.decodeAppState` instead.
+ *
+ * Converts an array of global/local state values from the algod api to a more friendly
+ * generic object keyed by the UTF-8 value of the key.
+ * @param state A `global-state`, `local-state`, `global-state-deltas` or `local-state-deltas`
+ * @returns An object keyeed by the UTF-8 representation of the key with various parsings of the values
+ */
+function decodeAppState(state) {
+    return AppManager.decodeAppState(state.map(({ key, value }) => ({ key: Buffer.from(key, 'utf-8'), value })));
+}
+/**
+ * @deprecated Use `TransactionComposer` methods to construct transactions instead.
+ *
+ * Returns the app args ready to load onto an app `Transaction` object
+ * @param args The app call args
+ * @returns The args ready to load into a `Transaction`
+ */
+function getAppArgsForTransaction(args) {
+    if (!args)
+        return undefined;
+    const encoder = new TextEncoder();
+    return {
+        accounts: args?.accounts?.map(_getAccountAddress),
+        appArgs: args?.appArgs?.map((a) => (typeof a === 'string' ? encoder.encode(a) : a)),
+        boxes: args.boxes?.map(getBoxReference),
+        foreignApps: args?.apps,
+        foreignAssets: args?.assets,
+        lease: encodeLease(args?.lease),
+    };
+}
+/**
+ * @deprecated Use `TransactionComposer` methods to construct transactions instead.
+ *
+ * Returns the app args ready to load onto an ABI method call in `AtomicTransactionComposer`
+ * @param args The ABI app call args
+ * @param from The transaction signer
+ * @returns The parameters ready to pass into `addMethodCall` within AtomicTransactionComposer
+ */
+async function getAppArgsForABICall(args, from) {
+    return _getAppArgsForABICall(args, from);
+}
+/**
+ * @deprecated Use `AppManager.getBoxReference()` instead.
+ *
+ * Returns a `algosdk.BoxReference` given a `BoxIdentifier` or `BoxReference`.
+ * @param box The box to return a reference for
+ * @returns The box reference ready to pass into a `Transaction`
+ */
+function getBoxReference(box) {
+    return _getBoxReference(box);
+}
+function _getAccountAddress(account) {
+    return typeof account === 'string' ? account : algosdk.encodeAddress(account.publicKey);
+}
+/**
+ * @deprecated Use `algorand.app.getById` instead.
+ *
+ * Gets the current data for the given app from algod.
+ *
+ * @param appId The id of the app
+ * @param algod An algod client
+ * @returns The data about the app
+ */
+async function getAppById(appId, algod) {
+    return await algod.getApplicationByID(toNumber(appId)).do();
+}
+/**
+ * @deprecated Use `algorand.app.compileTeal` instead.
+ *
+ * Compiles the given TEAL using algod and returns the result, including source map.
+ *
+ * @param algod An algod client
+ * @param tealCode The TEAL code
+ * @returns The information about the compiled file
+ */
+async function compileTeal(tealCode, algod) {
+    return await new AppManager(algod).compileTeal(tealCode);
+}
+/**
+ * @deprecated Use `abiMethod.getSignature()` or `new ABIMethod(abiMethodParams).getSignature()` instead.
+ *
+ * Returns the encoded ABI spec for a given ABI Method
+ * @param method The method to return a signature for
+ * @returns The encoded ABI method spec e.g. `method_name(uint64,string)string`
+ */
+const getABIMethodSignature = (method) => {
+    return 'getSignature' in method ? method.getSignature() : new ABIMethod(method).getSignature();
+};
+
+export { callApp, compileTeal, createApp, decodeAppState, getABIMethodSignature, getABIReturn, getAppArgsForABICall, getAppArgsForTransaction, getAppBoxNames, getAppBoxValue, getAppBoxValueFromABIType, getAppBoxValues, getAppBoxValuesFromABIType, getAppById, getAppGlobalState, getAppLocalState, getAppOnCompleteAction, getBoxReference, updateApp };
+//# sourceMappingURL=app.mjs.map

package/src/app.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.mjs","sources":["../../src/app.ts"],"sourcesContent":["import algosdk from 'algosdk'\nimport { _getAppArgsForABICall, _getBoxReference, legacySendAppTransactionBridge } from './transaction/legacy-bridge'\nimport { encodeLease, getSenderAddress } from './transaction/transaction'\nimport {\n  ABIAppCallArgs,\n  ABIReturn,\n  AppCallArgs,\n  AppCallParams,\n  AppCallTransactionResult,\n  AppCallType,\n  AppCompilationResult,\n  AppReference,\n  AppState,\n  BoxIdentifier,\n  BoxName,\n  BoxReference,\n  BoxValueRequestParams,\n  BoxValuesRequestParams,\n  CompiledTeal,\n  CreateAppParams,\n  RawAppCallArgs,\n  UpdateAppParams,\n} from './types/app'\nimport { AppManager } from './types/app-manager'\nimport { SendTransactionFrom } from './types/transaction'\nimport { toNumber } from './util'\nimport ABIMethod = algosdk.ABIMethod\nimport ABIMethodParams = algosdk.ABIMethodParams\nimport ABIValue = algosdk.ABIValue\nimport Address = algosdk.Address\nimport Algodv2 = algosdk.Algodv2\nimport modelsv2 = algosdk.modelsv2\nimport OnApplicationComplete = algosdk.OnApplicationComplete\n\n/**\n * @deprecated Use `algorand.send.appCreate()` / `algorand.createTransaction.appCreate()` / `algorand.send.appCreateMethodCall()`\n * / `algorand.createTransaction.appCreateMethodCall()` instead\n *\n * Creates a smart contract app, returns the details of the created app.\n * @param create The parameters to create the app with\n * @param algod An algod client\n * @returns The details of the created app, or the transaction to create it if `skipSending` and the compilation result\n */\nexport async function createApp(\n  create: CreateAppParams,\n  algod: Algodv2,\n): Promise<Partial<AppCompilationResult> & AppCallTransactionResult & AppReference> {\n  const onComplete = getAppOnCompleteAction(create.onCompleteAction)\n  if (onComplete === algosdk.OnApplicationComplete.ClearStateOC) {\n    throw new Error('Cannot create an app with on-complete action of ClearState')\n  }\n\n  const result = create.args?.method\n    ? await legacySendAppTransactionBridge(\n        algod,\n        create.from,\n        create.args,\n        create,\n        {\n          sender: getSenderAddress(create.from),\n          onComplete,\n          approvalProgram: create.approvalProgram,\n          clearStateProgram: create.clearStateProgram,\n          method: create.args.method instanceof ABIMethod ? create.args.method : new ABIMethod(create.args.method),\n          extraProgramPages: create.schema.extraPages,\n          schema: create.schema,\n        },\n        (c) => c.appCreateMethodCall,\n        (c) => c.appCreateMethodCall,\n      )\n    : await legacySendAppTransactionBridge(\n        algod,\n        create.from,\n        create.args,\n        create,\n        {\n          sender: getSenderAddress(create.from),\n          onComplete,\n          approvalProgram: create.approvalProgram,\n          clearStateProgram: create.clearStateProgram,\n          extraProgramPages: create.schema.extraPages,\n          schema: create.schema,\n        },\n        (c) => c.appCreate,\n        (c) => c.appCreate,\n      )\n\n  return {\n    ...result,\n    appId: 'appId' in result ? Number(result.appId) : 0,\n    appAddress: 'appAddress' in result ? result.appAddress.toString() : '',\n  }\n}\n\n/**\n * @deprecated Use `algorand.send.appUpdate()` / `algorand.createTransaction.appUpdate()` / `algorand.send.appUpdateMethodCall()`\n * / `algorand.createTransaction.appUpdateMethodCall()` instead\n *\n * Updates a smart contract app.\n * @param update The parameters to update the app with\n * @param algod An algod client\n * @returns The transaction send result and the compilation result\n */\nexport async function updateApp(\n  update: UpdateAppParams,\n  algod: Algodv2,\n): Promise<Partial<AppCompilationResult> & AppCallTransactionResult> {\n  return update.args?.method\n    ? await legacySendAppTransactionBridge(\n        algod,\n        update.from,\n        update.args,\n        update,\n        {\n          appId: BigInt(update.appId),\n          sender: getSenderAddress(update.from),\n          onComplete: algosdk.OnApplicationComplete.UpdateApplicationOC,\n          approvalProgram: update.approvalProgram,\n          clearStateProgram: update.clearStateProgram,\n          method: update.args.method instanceof ABIMethod ? update.args.method : new ABIMethod(update.args.method),\n        },\n        (c) => c.appUpdateMethodCall,\n        (c) => c.appUpdateMethodCall,\n      )\n    : await legacySendAppTransactionBridge(\n        algod,\n        update.from,\n        update.args,\n        update,\n        {\n          appId: BigInt(update.appId),\n          sender: getSenderAddress(update.from),\n          onComplete: algosdk.OnApplicationComplete.UpdateApplicationOC,\n          approvalProgram: update.approvalProgram,\n          clearStateProgram: update.clearStateProgram,\n        },\n        (c) => c.appUpdate,\n        (c) => c.appUpdate,\n      )\n}\n\n/**\n * @deprecated Use `algosdk.OnApplicationComplete` directly instead.\n *\n * Returns a `algosdk.OnApplicationComplete` for the given onCompleteAction.\n *\n * If given `undefined` will return `OnApplicationComplete.NoOpOC`.\n *\n * If given an `AppCallType` will convert the string enum to the correct underlying `algosdk.OnApplicationComplete`.\n *\n * @param onCompletionAction The on completion action\n * @returns The `algosdk.OnApplicationComplete`\n */\nexport function getAppOnCompleteAction(onCompletionAction?: AppCallType | OnApplicationComplete) {\n  switch (onCompletionAction) {\n    case undefined:\n    case 'no_op':\n    case OnApplicationComplete.NoOpOC:\n      return OnApplicationComplete.NoOpOC\n    case 'opt_in':\n    case OnApplicationComplete.OptInOC:\n      return OnApplicationComplete.OptInOC\n    case 'close_out':\n    case OnApplicationComplete.CloseOutOC:\n      return OnApplicationComplete.CloseOutOC\n    case 'clear_state':\n    case OnApplicationComplete.ClearStateOC:\n      return OnApplicationComplete.ClearStateOC\n    case 'update_application':\n    case OnApplicationComplete.UpdateApplicationOC:\n      return OnApplicationComplete.UpdateApplicationOC\n    case 'delete_application':\n    case OnApplicationComplete.DeleteApplicationOC:\n      return OnApplicationComplete.DeleteApplicationOC\n  }\n}\n\n/**\n * @deprecated Use `algorand.send.appUpdate()` / `algorand.createTransaction.appUpdate()` / `algorand.send.appUpdateMethodCall()`\n * / `algorand.createTransaction.appUpdateMethodCall()` instead\n *\n * Issues a call to a given app.\n * @param call The call details.\n * @param algod An algod client\n * @returns The result of the call\n */\nexport async function callApp(call: AppCallParams, algod: Algodv2): Promise<AppCallTransactionResult> {\n  const onComplete = getAppOnCompleteAction(call.callType)\n  if (onComplete === algosdk.OnApplicationComplete.UpdateApplicationOC) {\n    throw new Error('Cannot execute an app call with on-complete action of Update')\n  }\n  if (call.args?.method && onComplete === algosdk.OnApplicationComplete.ClearStateOC) {\n    throw new Error('Cannot execute an ABI method call with on-complete action of ClearState')\n  }\n\n  return call.args?.method\n    ? await legacySendAppTransactionBridge(\n        algod,\n        call.from,\n        call.args,\n        call,\n        {\n          appId: BigInt(call.appId),\n          sender: getSenderAddress(call.from),\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          onComplete: onComplete as any,\n          method: call.args.method instanceof ABIMethod ? call.args.method : new ABIMethod(call.args.method),\n        },\n        (c) => c.appCallMethodCall,\n        (c) => c.appCallMethodCall,\n      )\n    : await legacySendAppTransactionBridge(\n        algod,\n        call.from,\n        call.args,\n        call,\n        {\n          appId: BigInt(call.appId),\n          sender: getSenderAddress(call.from),\n          onComplete,\n        },\n        (c) => c.appCall,\n        (c) => c.appCall,\n      )\n}\n\n/**\n * @deprecated Use `AppManager.getABIReturn` instead.\n *\n * Returns any ABI return values for the given app call arguments and transaction confirmation.\n * @param args The arguments that were used for the call\n * @param confirmation The transaction confirmation from algod\n * @returns The return value for the method call\n */\nexport function getABIReturn(args?: AppCallArgs, confirmation?: modelsv2.PendingTransactionResponse): ABIReturn | undefined {\n  if (!args || !args.method) {\n    return undefined\n  }\n  const method = 'txnCount' in args.method ? args.method : new ABIMethod(args.method)\n\n  return AppManager.getABIReturn(confirmation, method)\n}\n\n/**\n * @deprecated Use `algorand.app.getGlobalState` instead.\n *\n * Returns the current global state values for the given app ID\n * @param appId The ID of the app return global state for\n * @param algod An algod client instance\n * @returns The current global state\n */\nexport async function getAppGlobalState(appId: number | bigint, algod: Algodv2) {\n  return await new AppManager(algod).getGlobalState(BigInt(appId))\n}\n\n/**\n * @deprecated Use `algorand.app.getLocalState` instead.\n *\n * Returns the current global state values for the given app ID and account\n * @param appId The ID of the app return global state for\n * @param account Either the string address of an account or an account object for the account to get local state for the given app\n * @param algod An algod client instance\n * @returns The current local state for the given (app, account) combination\n */\nexport async function getAppLocalState(appId: number | bigint, account: string | SendTransactionFrom, algod: Algodv2) {\n  return new AppManager(algod).getLocalState(BigInt(appId), getSenderAddress(account))\n}\n\n/**\n * @deprecated Use `algorand.app.getBoxNames` instead.\n * Returns the names of the boxes for the given app.\n * @param appId The ID of the app return box names for\n * @param algod An algod client instance\n * @returns The current box names\n */\nexport async function getAppBoxNames(appId: number | bigint, algod: Algodv2): Promise<BoxName[]> {\n  return new AppManager(algod).getBoxNames(BigInt(appId))\n}\n\n/**\n * @deprecated Use `algorand.app.getBoxValue` instead.\n * Returns the value of the given box name for the given app.\n * @param appId The ID of the app return box names for\n * @param boxName The name of the box to return either as a string, binary array or `BoxName`\n * @param algod An algod client instance\n * @returns The current box value as a byte array\n */\nexport async function getAppBoxValue(appId: number | bigint, boxName: string | Uint8Array | BoxName, algod: Algodv2): Promise<Uint8Array> {\n  return new AppManager(algod).getBoxValue(BigInt(appId), typeof boxName !== 'string' && 'name' in boxName ? boxName.nameRaw : boxName)\n}\n\n/**\n * @deprecated Use `algorand.app.getBoxValues` instead.\n * Returns the value of the given box names for the given app.\n * @param appId The ID of the app return box names for\n * @param boxNames The names of the boxes to return either as a string, binary array or `BoxName`\n * @param algod An algod client instance\n * @returns The current box values as a byte array in the same order as the passed in box names\n */\nexport async function getAppBoxValues(appId: number, boxNames: (string | Uint8Array | BoxName)[], algod: Algodv2): Promise<Uint8Array[]> {\n  return new AppManager(algod).getBoxValues(\n    BigInt(appId),\n    boxNames.map((b) => (typeof b !== 'string' && 'name' in b ? b.nameRaw : b)),\n  )\n}\n\n/**\n * @deprecated Use `algorand.app.getBoxValueFromABIType` instead.\n * Returns the value of the given box name for the given app decoded based on the given ABI type.\n * @param request The parameters for the box value request\n * @param algod An algod client instance\n * @returns The current box value as an ABI value\n */\nexport async function getAppBoxValueFromABIType(request: BoxValueRequestParams, algod: Algodv2): Promise<ABIValue> {\n  return new AppManager(algod).getBoxValueFromABIType({\n    appId: BigInt(request.appId),\n    boxName: typeof request.boxName !== 'string' && 'name' in request.boxName ? request.boxName.nameRaw : request.boxName,\n    type: request.type,\n  })\n}\n\n/**\n * @deprecated Use `algorand.app.getBoxValuesFromABIType` instead.\n * Returns the value of the given box names for the given app decoded based on the given ABI type.\n * @param request The parameters for the box value request\n * @param algod An algod client instance\n * @returns The current box values as an ABI value in the same order as the passed in box names\n */\nexport async function getAppBoxValuesFromABIType(request: BoxValuesRequestParams, algod: Algodv2): Promise<ABIValue[]> {\n  return new AppManager(algod).getBoxValuesFromABIType({\n    appId: BigInt(request.appId),\n    boxNames: request.boxNames.map((b) => (typeof b !== 'string' && 'name' in b ? b.nameRaw : b)),\n    type: request.type,\n  })\n}\n\n/**\n * @deprecated Use `AppManager.decodeAppState` instead.\n *\n * Converts an array of global/local state values from the algod api to a more friendly\n * generic object keyed by the UTF-8 value of the key.\n * @param state A `global-state`, `local-state`, `global-state-deltas` or `local-state-deltas`\n * @returns An object keyeed by the UTF-8 representation of the key with various parsings of the values\n */\nexport function decodeAppState(state: { key: string; value: modelsv2.TealValue | modelsv2.EvalDelta }[]): AppState {\n  return AppManager.decodeAppState(state.map(({ key, value }) => ({ key: Buffer.from(key, 'utf-8'), value })))\n}\n\n/**\n * @deprecated Use `TransactionComposer` methods to construct transactions instead.\n *\n * Returns the app args ready to load onto an app `Transaction` object\n * @param args The app call args\n * @returns The args ready to load into a `Transaction`\n */\nexport function getAppArgsForTransaction(args?: RawAppCallArgs) {\n  if (!args) return undefined\n\n  const encoder = new TextEncoder()\n  return {\n    accounts: args?.accounts?.map(_getAccountAddress),\n    appArgs: args?.appArgs?.map((a) => (typeof a === 'string' ? encoder.encode(a) : a)),\n    boxes: args.boxes?.map(getBoxReference),\n    foreignApps: args?.apps,\n    foreignAssets: args?.assets,\n    lease: encodeLease(args?.lease),\n  }\n}\n\n/**\n * @deprecated Use `TransactionComposer` methods to construct transactions instead.\n *\n * Returns the app args ready to load onto an ABI method call in `AtomicTransactionComposer`\n * @param args The ABI app call args\n * @param from The transaction signer\n * @returns The parameters ready to pass into `addMethodCall` within AtomicTransactionComposer\n */\nexport async function getAppArgsForABICall(args: ABIAppCallArgs, from: SendTransactionFrom) {\n  return _getAppArgsForABICall(args, from)\n}\n\n/**\n * @deprecated Use `AppManager.getBoxReference()` instead.\n *\n * Returns a `algosdk.BoxReference` given a `BoxIdentifier` or `BoxReference`.\n * @param box The box to return a reference for\n * @returns The box reference ready to pass into a `Transaction`\n */\nexport function getBoxReference(box: BoxIdentifier | BoxReference | algosdk.BoxReference): algosdk.BoxReference {\n  return _getBoxReference(box)\n}\n\nfunction _getAccountAddress(account: string | Address) {\n  return typeof account === 'string' ? account : algosdk.encodeAddress(account.publicKey)\n}\n\n/**\n * @deprecated Use `algorand.app.getById` instead.\n *\n * Gets the current data for the given app from algod.\n *\n * @param appId The id of the app\n * @param algod An algod client\n * @returns The data about the app\n */\nexport async function getAppById(appId: number | bigint, algod: Algodv2) {\n  return await algod.getApplicationByID(toNumber(appId)).do()\n}\n\n/**\n * @deprecated Use `algorand.app.compileTeal` instead.\n *\n * Compiles the given TEAL using algod and returns the result, including source map.\n *\n * @param algod An algod client\n * @param tealCode The TEAL code\n * @returns The information about the compiled file\n */\nexport async function compileTeal(tealCode: string, algod: Algodv2): Promise<CompiledTeal> {\n  return await new AppManager(algod).compileTeal(tealCode)\n}\n\n/**\n * @deprecated Use `abiMethod.getSignature()` or `new ABIMethod(abiMethodParams).getSignature()` instead.\n *\n * Returns the encoded ABI spec for a given ABI Method\n * @param method The method to return a signature for\n * @returns The encoded ABI method spec e.g. `method_name(uint64,string)string`\n */\nexport const getABIMethodSignature = (method: ABIMethodParams | ABIMethod) => {\n  return 'getSignature' in method ? method.getSignature() : new ABIMethod(method).getSignature()\n}\n"],"names":[],"mappings":"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"}

package/src/asset.js

@@ -0,0 +1,142 @@
+'use strict';
+
+var legacyBridge = require('./transaction/legacy-bridge.js');
+var types_algorandClient = require('../types/algorand-client.js');
+var transaction = require('./transaction/transaction.js');
+
+/**
+ * @deprecated use `algorand.send.assetCreate()` / `algorand.createTransaction.assetCreate()` instead
+ *
+ * Create an Algorand Standard Asset (ASA).
+ * @param create The asset creation definition
+ * @param algod An algod client
+ * @returns The transaction object and optionally the confirmation if it was sent to the chain (`skipSending` is `false` or unset)
+ *
+ * @example Usage example
+ * ```typescript
+ * await algokit.createAsset({ creator: account, total: 1, decimals: 0, name: 'My asset' }, algod)
+ * ```
+ */
+async function createAsset(create, algod) {
+    const params = {
+        sender: transaction.getSenderAddress(create.creator),
+        total: BigInt(create.total),
+        decimals: create.decimals,
+        assetName: create.name,
+        unitName: create.unit,
+        manager: create.manager ? transaction.getSenderAddress(create.manager) : undefined,
+        clawback: create.clawbackAccount ? transaction.getSenderAddress(create.clawbackAccount) : undefined,
+        freeze: create.freezeAccount ? transaction.getSenderAddress(create.freezeAccount) : undefined,
+        reserve: create.reserveAccount ? transaction.getSenderAddress(create.reserveAccount) : undefined,
+        defaultFrozen: create.frozenByDefault,
+        lease: create.lease,
+        metadataHash: create.metadataHash,
+        note: transaction.encodeTransactionNote(create.note),
+        url: create.url,
+    };
+    return (await legacyBridge.legacySendTransactionBridge(algod, create.creator, create, params, (client) => client.assetCreate, (client) => client.assetCreate));
+}
+/**
+ * @deprecated use `algorand.send.assetOptIn()` / `algorand.createTransaction.assetOptIn()` instead
+ *
+ * Opt-in an account to an asset.
+ * @param optIn The opt-in definition
+ * @param algod An algod client
+ * @returns The transaction object and optionally the confirmation if it was sent to the chain (`skipSending` is `false` or unset)
+ *
+ * @example Usage example
+ * ```typescript
+ * await algokit.assetOptIn({ account, assetId }, algod)
+ * ```
+ */
+async function assetOptIn(optIn, algod) {
+    const params = {
+        assetId: BigInt(optIn.assetId),
+        sender: transaction.getSenderAddress(optIn.account),
+        note: transaction.encodeTransactionNote(optIn.note),
+        lease: optIn.lease,
+    };
+    return legacyBridge.legacySendTransactionBridge(algod, optIn.account, optIn, params, (c) => c.assetOptIn, (c) => c.assetOptIn);
+}
+/**
+ * @deprecated use `algorand.send.assetOptOut()` / `algorand.createTransaction.assetOptOut()` instead
+ *
+ * Opt-out an account from an asset.
+ * @param optOut The opt-in definition
+ * @param algod An algod client
+ * @returns The transaction object and optionally the confirmation if it was sent to the chain (`skipSending` is `false` or unset)
+ *
+ * @example Usage example
+ * ```typescript
+ * await algokit.assetOptOut({ account, assetId, assetCreatorAddress }, algod)
+ * ```
+ */
+async function assetOptOut(optOut, algod) {
+    const assetCreatorAddress = optOut.assetCreatorAddress ?? (await algod.getAssetByID(optOut.assetId).do()).params.creator;
+    const params = {
+        assetId: BigInt(optOut.assetId),
+        creator: assetCreatorAddress,
+        sender: transaction.getSenderAddress(optOut.account),
+        note: transaction.encodeTransactionNote(optOut.note),
+        lease: optOut.lease,
+    };
+    return legacyBridge.legacySendTransactionBridge(algod, optOut.account, optOut, params, (c) => c.assetOptOut, (c) => (params) => c.assetOptOut({ ...params, ensureZeroBalance: optOut.ensureZeroBalance ?? true }));
+}
+/**
+ * @deprecated use `algorand.asset.bulkOptIn()` instead
+ *
+ * Opt in to a list of assets on the Algorand blockchain.
+ *
+ * @param optIn - The bulk opt-in request.
+ * @param algod - An instance of the Algodv2 class from the `algosdk` library.
+ * @returns A record object where the keys are the asset IDs and the values are the corresponding transaction IDs for successful opt-ins.
+ * @throws If there is an error during the opt-in process.
+ * @example algokit.bulkOptIn({ account: account, assetIds: [12345, 67890] }, algod)
+ */
+async function assetBulkOptIn(optIn, algod) {
+    const result = await types_algorandClient.AlgorandClient.fromClients({ algod })
+        .setSignerFromAccount(optIn.account)
+        .asset.bulkOptIn(transaction.getSenderAddress(optIn.account), optIn.assetIds.map(BigInt), {
+        note: transaction.encodeTransactionNote(optIn.note),
+        maxFee: optIn.maxFee,
+        suppressLog: optIn.suppressLog,
+    });
+    const returnResult = {};
+    for (const r of result) {
+        returnResult[Number(r.assetId)] = r.transactionId;
+    }
+    return returnResult;
+}
+/**
+ * @deprecated use `algorand.asset.bulkOptOut()` instead
+ *
+ * Opt out of multiple assets in Algorand blockchain.
+ *
+ * @param optOut The bulk opt-out request.
+ * @param algod - An instance of the Algodv2 client used to interact with the Algorand blockchain.
+ * @returns A record object containing asset IDs as keys and their corresponding transaction IDs as values.
+ * @throws If there is an error during the opt-out process.
+ * @example algokit.bulkOptOut({ account: account, assetIds: [12345, 67890] }, algod)
+ */
+async function assetBulkOptOut(optOut, algod) {
+    const result = await types_algorandClient.AlgorandClient.fromClients({ algod })
+        .setSignerFromAccount(optOut.account)
+        .asset.bulkOptOut(transaction.getSenderAddress(optOut.account), optOut.assetIds.map(BigInt), {
+        ensureZeroBalance: optOut.validateBalances ?? true,
+        note: transaction.encodeTransactionNote(optOut.note),
+        maxFee: optOut.maxFee,
+        suppressLog: optOut.suppressLog,
+    });
+    const returnResult = {};
+    for (const r of result) {
+        returnResult[Number(r.assetId)] = r.transactionId;
+    }
+    return returnResult;
+}
+
+exports.assetBulkOptIn = assetBulkOptIn;
+exports.assetBulkOptOut = assetBulkOptOut;
+exports.assetOptIn = assetOptIn;
+exports.assetOptOut = assetOptOut;
+exports.createAsset = createAsset;
+//# sourceMappingURL=asset.js.map

package/src/asset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset.js","sources":["../../src/asset.ts"],"sourcesContent":["import algosdk from 'algosdk'\nimport { encodeTransactionNote, getSenderAddress } from './transaction'\nimport { legacySendTransactionBridge } from './transaction/legacy-bridge'\nimport { AlgorandClient } from './types/algorand-client'\nimport { AssetBulkOptInOutParams, AssetOptInParams, AssetOptOutParams, CreateAssetParams } from './types/asset'\nimport { AssetCreateParams, AssetOptInParams as NewAssetOptInParams, AssetOptOutParams as NewAssetOptOutParams } from './types/composer'\nimport { SendTransactionResult } from './types/transaction'\nimport Algodv2 = algosdk.Algodv2\n\n/**\n * @deprecated use `algorand.send.assetCreate()` / `algorand.createTransaction.assetCreate()` instead\n *\n * Create an Algorand Standard Asset (ASA).\n * @param create The asset creation definition\n * @param algod An algod client\n * @returns The transaction object and optionally the confirmation if it was sent to the chain (`skipSending` is `false` or unset)\n *\n * @example Usage example\n * ```typescript\n * await algokit.createAsset({ creator: account, total: 1, decimals: 0, name: 'My asset' }, algod)\n * ```\n */\nexport async function createAsset(\n  create: CreateAssetParams,\n  algod: Algodv2,\n): Promise<SendTransactionResult & { confirmation?: { assetIndex: number | bigint } }> {\n  const params: AssetCreateParams = {\n    sender: getSenderAddress(create.creator),\n    total: BigInt(create.total),\n    decimals: create.decimals,\n    assetName: create.name,\n    unitName: create.unit,\n    manager: create.manager ? getSenderAddress(create.manager) : undefined,\n    clawback: create.clawbackAccount ? getSenderAddress(create.clawbackAccount) : undefined,\n    freeze: create.freezeAccount ? getSenderAddress(create.freezeAccount) : undefined,\n    reserve: create.reserveAccount ? getSenderAddress(create.reserveAccount) : undefined,\n    defaultFrozen: create.frozenByDefault,\n    lease: create.lease,\n    metadataHash: create.metadataHash,\n    note: encodeTransactionNote(create.note),\n    url: create.url,\n  }\n\n  return (await legacySendTransactionBridge(\n    algod,\n    create.creator,\n    create,\n    params,\n    (client) => client.assetCreate,\n    (client) => client.assetCreate,\n  )) as SendTransactionResult & { confirmation: { assetIndex: number | bigint } }\n}\n\n/**\n * @deprecated use `algorand.send.assetOptIn()` / `algorand.createTransaction.assetOptIn()` instead\n *\n * Opt-in an account to an asset.\n * @param optIn The opt-in definition\n * @param algod An algod client\n * @returns The transaction object and optionally the confirmation if it was sent to the chain (`skipSending` is `false` or unset)\n *\n * @example Usage example\n * ```typescript\n * await algokit.assetOptIn({ account, assetId }, algod)\n * ```\n */\nexport async function assetOptIn(optIn: AssetOptInParams, algod: Algodv2): Promise<SendTransactionResult> {\n  const params: NewAssetOptInParams = {\n    assetId: BigInt(optIn.assetId),\n    sender: getSenderAddress(optIn.account),\n    note: encodeTransactionNote(optIn.note),\n    lease: optIn.lease,\n  }\n\n  return legacySendTransactionBridge(\n    algod,\n    optIn.account,\n    optIn,\n    params,\n    (c) => c.assetOptIn,\n    (c) => c.assetOptIn,\n  )\n}\n\n/**\n * @deprecated use `algorand.send.assetOptOut()` / `algorand.createTransaction.assetOptOut()` instead\n *\n * Opt-out an account from an asset.\n * @param optOut The opt-in definition\n * @param algod An algod client\n * @returns The transaction object and optionally the confirmation if it was sent to the chain (`skipSending` is `false` or unset)\n *\n * @example Usage example\n * ```typescript\n * await algokit.assetOptOut({ account, assetId, assetCreatorAddress }, algod)\n * ```\n */\nexport async function assetOptOut(optOut: AssetOptOutParams, algod: Algodv2): Promise<SendTransactionResult> {\n  const assetCreatorAddress = optOut.assetCreatorAddress ?? (await algod.getAssetByID(optOut.assetId).do()).params.creator\n\n  const params: NewAssetOptOutParams = {\n    assetId: BigInt(optOut.assetId),\n    creator: assetCreatorAddress,\n    sender: getSenderAddress(optOut.account),\n    note: encodeTransactionNote(optOut.note),\n    lease: optOut.lease,\n  }\n\n  return legacySendTransactionBridge(\n    algod,\n    optOut.account,\n    optOut,\n    params,\n    (c) => c.assetOptOut,\n    (c) => (params: NewAssetOptOutParams) => c.assetOptOut({ ...params, ensureZeroBalance: optOut.ensureZeroBalance ?? true }),\n  )\n}\n\n/**\n * @deprecated use `algorand.asset.bulkOptIn()` instead\n *\n * Opt in to a list of assets on the Algorand blockchain.\n *\n * @param optIn - The bulk opt-in request.\n * @param algod - An instance of the Algodv2 class from the `algosdk` library.\n * @returns A record object where the keys are the asset IDs and the values are the corresponding transaction IDs for successful opt-ins.\n * @throws If there is an error during the opt-in process.\n * @example algokit.bulkOptIn({ account: account, assetIds: [12345, 67890] }, algod)\n */\nexport async function assetBulkOptIn(optIn: AssetBulkOptInOutParams, algod: Algodv2): Promise<Record<number, string>> {\n  const result = await AlgorandClient.fromClients({ algod })\n    .setSignerFromAccount(optIn.account)\n    .asset.bulkOptIn(getSenderAddress(optIn.account), optIn.assetIds.map(BigInt), {\n      note: encodeTransactionNote(optIn.note),\n      maxFee: optIn.maxFee,\n      suppressLog: optIn.suppressLog,\n    })\n\n  const returnResult: Record<number, string> = {}\n  for (const r of result) {\n    returnResult[Number(r.assetId)] = r.transactionId\n  }\n  return returnResult\n}\n\n/**\n * @deprecated use `algorand.asset.bulkOptOut()` instead\n *\n * Opt out of multiple assets in Algorand blockchain.\n *\n * @param optOut The bulk opt-out request.\n * @param algod - An instance of the Algodv2 client used to interact with the Algorand blockchain.\n * @returns A record object containing asset IDs as keys and their corresponding transaction IDs as values.\n * @throws If there is an error during the opt-out process.\n * @example algokit.bulkOptOut({ account: account, assetIds: [12345, 67890] }, algod)\n */\nexport async function assetBulkOptOut(optOut: AssetBulkOptInOutParams, algod: Algodv2): Promise<Record<number, string>> {\n  const result = await AlgorandClient.fromClients({ algod })\n    .setSignerFromAccount(optOut.account)\n    .asset.bulkOptOut(getSenderAddress(optOut.account), optOut.assetIds.map(BigInt), {\n      ensureZeroBalance: optOut.validateBalances ?? true,\n      note: encodeTransactionNote(optOut.note),\n      maxFee: optOut.maxFee,\n      suppressLog: optOut.suppressLog,\n    })\n\n  const returnResult: Record<number, string> = {}\n  for (const r of result) {\n    returnResult[Number(r.assetId)] = r.transactionId\n  }\n  return returnResult\n}\n"],"names":["getSenderAddress","encodeTransactionNote","legacySendTransactionBridge","AlgorandClient"],"mappings":"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"}