@algorandfoundation/algokit-utils 9.1.2 → 9.2.0-beta.10

package/types/composer.mjs

@@ -399,6 +399,7 @@ class TransactionComposer {
      *  appReferences: [123n, 1234n]
      *  assetReferences: [12345n]
      *  boxReferences: ["box1", {appId: 1234n, name: "box2"}]
+     *  accessReferences: [{ appId: 1234n }]
      *  lease: 'lease',
      *  note: 'note',
      *  // You wouldn't normally set this field
@@ -409,6 +410,7 @@ class TransactionComposer {
      *  // Max fee doesn't make sense with extraFee AND staticFee
      *  //  already specified, but here for completeness
      *  maxFee: (3000).microAlgo(),
+     *  rejectVersion: 1,
      *  // Signer only needed if you want to provide one,
      *  //  generally you'd register it with AlgorandClient
      *  //  against the sender and not need to pass it in
@@ -444,6 +446,7 @@ class TransactionComposer {
      *  appReferences: [123n, 1234n]
      *  assetReferences: [12345n]
      *  boxReferences: ["box1", {appId: 1234n, name: "box2"}]
+     *  accessReferences: [{ appId: 1234n }]
      *  lease: 'lease',
      *  note: 'note',
      *  // You wouldn't normally set this field
@@ -454,6 +457,7 @@ class TransactionComposer {
      *  // Max fee doesn't make sense with extraFee AND staticFee
      *  //  already specified, but here for completeness
      *  maxFee: (3000).microAlgo(),
+     *  rejectVersion: 1,
      *})
      * ```
      */
@@ -481,6 +485,7 @@ class TransactionComposer {
      *  appReferences: [123n, 1234n]
      *  assetReferences: [12345n]
      *  boxReferences: ["box1", {appId: 1234n, name: "box2"}]
+     *  accessReferences: [{ appId: 1234n }]
      *  lease: 'lease',
      *  note: 'note',
      *  // You wouldn't normally set this field
@@ -491,6 +496,7 @@ class TransactionComposer {
      *  // Max fee doesn't make sense with extraFee AND staticFee
      *  //  already specified, but here for completeness
      *  maxFee: (3000).microAlgo(),
+     *  rejectVersion: 1,
      *})
      * ```
      */
@@ -520,6 +526,7 @@ class TransactionComposer {
      *  appReferences: [123n, 1234n]
      *  assetReferences: [12345n]
      *  boxReferences: ["box1", {appId: 1234n, name: "box2"}]
+     *  accessReferences: [{ appId: 1234n }]
      *  lease: 'lease',
      *  note: 'note',
      *  // You wouldn't normally set this field
@@ -530,6 +537,7 @@ class TransactionComposer {
      *  // Max fee doesn't make sense with extraFee AND staticFee
      *  //  already specified, but here for completeness
      *  maxFee: (3000).microAlgo(),
+     *  rejectVersion: 1,
      *})
      * ```
      */
@@ -578,6 +586,7 @@ class TransactionComposer {
      *  appReferences: [123n, 1234n]
      *  assetReferences: [12345n]
      *  boxReferences: ["box1", {appId: 1234n, name: "box2"}]
+     *  accessReferences: [{ appId: 1234n }]
      *  lease: 'lease',
      *  note: 'note',
      *  // You wouldn't normally set this field
@@ -588,6 +597,7 @@ class TransactionComposer {
      *  // Max fee doesn't make sense with extraFee AND staticFee
      *  //  already specified, but here for completeness
      *  maxFee: (3000).microAlgo(),
+     *  rejectVersion: 1,
      *})
      * ```
      */
@@ -629,6 +639,7 @@ class TransactionComposer {
      *  appReferences: [123n, 1234n]
      *  assetReferences: [12345n]
      *  boxReferences: ["box1", {appId: 1234n, name: "box2"}]
+     *  accessReferences: [{ appId: 1234n }]
      *  lease: 'lease',
      *  note: 'note',
      *  // You wouldn't normally set this field
@@ -639,6 +650,7 @@ class TransactionComposer {
      *  // Max fee doesn't make sense with extraFee AND staticFee
      *  //  already specified, but here for completeness
      *  maxFee: (3000).microAlgo(),
+     *  rejectVersion: 1,
      *})
      * ```
      */
@@ -678,6 +690,7 @@ class TransactionComposer {
      *  appReferences: [123n, 1234n]
      *  assetReferences: [12345n]
      *  boxReferences: ["box1", {appId: 1234n, name: "box2"}]
+     *  accessReferences: [{ appId: 1234n }]
      *  lease: 'lease',
      *  note: 'note',
      *  // You wouldn't normally set this field
@@ -688,6 +701,7 @@ class TransactionComposer {
      *  // Max fee doesn't make sense with extraFee AND staticFee
      *  //  already specified, but here for completeness
      *  maxFee: (3000).microAlgo(),
+     *  rejectVersion: 1,
      *})
      * ```
      */
@@ -727,6 +741,7 @@ class TransactionComposer {
      *  appReferences: [123n, 1234n]
      *  assetReferences: [12345n]
      *  boxReferences: ["box1", {appId: 1234n, name: "box2"}]
+     *  accessReferences: [{ appId: 1234n }]
      *  lease: 'lease',
      *  note: 'note',
      *  // You wouldn't normally set this field
@@ -737,6 +752,7 @@ class TransactionComposer {
      *  // Max fee doesn't make sense with extraFee AND staticFee
      *  //  already specified, but here for completeness
      *  maxFee: (3000).microAlgo(),
+     *  rejectVersion: 1,
      *})
      * ```
      */
@@ -910,7 +926,12 @@ class TransactionComposer {
         const isAbiValue = (x) => {
             if (Array.isArray(x))
                 return x.length == 0 || x.every(isAbiValue);
-            return typeof x === 'bigint' || typeof x === 'boolean' || typeof x === 'number' || typeof x === 'string' || x instanceof Uint8Array;
+            return (typeof x === 'bigint' ||
+                typeof x === 'boolean' ||
+                typeof x === 'number' ||
+                typeof x === 'string' ||
+                x instanceof Uint8Array ||
+                x instanceof algosdk.Address);
         };
         for (let i = (params.args ?? []).length - 1; i >= 0; i--) {
             const arg = params.args[i];
@@ -1005,6 +1026,7 @@ class TransactionComposer {
             appForeignApps: params.appReferences?.map((x) => Number(x)),
             appForeignAssets: params.assetReferences?.map((x) => Number(x)),
             boxes: params.boxReferences?.map(AppManager.getBoxReference),
+            access: params.accessReferences?.map(getResourceReference),
             approvalProgram,
             clearProgram: clearStateProgram,
             extraPages: appId === 0
@@ -1035,6 +1057,7 @@ class TransactionComposer {
                 return arg;
             })
                 .reverse(),
+            rejectVersion: params.rejectVersion,
             // note, lease, and rekeyTo are set in the common build step
             note: undefined,
             lease: undefined,
@@ -1144,8 +1167,10 @@ class TransactionComposer {
             foreignApps: params.appReferences?.map((x) => Number(x)),
             foreignAssets: params.assetReferences?.map((x) => Number(x)),
             boxes: params.boxReferences?.map(AppManager.getBoxReference),
+            access: params.accessReferences?.map(getResourceReference),
             approvalProgram,
             clearProgram: clearStateProgram,
+            rejectVersion: params.rejectVersion,
         };
         if (appId === 0n) {
             if (sdkParams.approvalProgram === undefined || sdkParams.clearProgram === undefined) {
@@ -1315,7 +1340,8 @@ class TransactionComposer {
             });
             this.atc['methodCalls'] = methodCalls;
         }
-        return { atc: this.atc, transactions: this.atc.buildGroup(), methodCalls: this.atc['methodCalls'] };
+        const transactions = this.atc.buildGroup();
+        return { atc: this.atc, transactions, methodCalls: this.atc['methodCalls'] };
     }
     /**
      * Rebuild the group, discarding any previously built transactions.
@@ -1452,6 +1478,31 @@ class TransactionComposer {
 }
 /** Signer used to represent a lack of signer */
 TransactionComposer.NULL_SIGNER = algosdk.makeEmptyTransactionSigner();
+/**
+ * Returns an `algosdk.TransactionResourceReference` given a `ResourceReference`.
+ */
+function getResourceReference(accessReference) {
+    return {
+        address: typeof accessReference.address === 'string' ? Address.fromString(accessReference.address) : accessReference.address,
+        appIndex: accessReference.appId,
+        assetIndex: accessReference.assetId,
+        holding: accessReference.holding ? getHoldingReference(accessReference.holding) : undefined,
+        locals: accessReference.locals ? getLocalsReference(accessReference.locals) : undefined,
+        box: accessReference.box ? AppManager.getBoxReference(accessReference.box) : undefined,
+    };
+}
+function getHoldingReference(holdingReference) {
+    return {
+        assetIndex: holdingReference.assetId,
+        address: typeof holdingReference.address === 'string' ? Address.fromString(holdingReference.address) : holdingReference.address,
+    };
+}
+function getLocalsReference(localsReference) {
+    return {
+        appIndex: localsReference.appId,
+        address: typeof localsReference.address === 'string' ? Address.fromString(localsReference.address) : localsReference.address,
+    };
+}
 
 export { MAX_TRANSACTION_GROUP_SIZE, TransactionComposer };
 //# sourceMappingURL=composer.mjs.map