stxer 0.4.1 → 0.4.3

package/src/sample/counter.ts

@@ -1,12 +1,14 @@
 import { uintCV } from '@stacks/transactions';
 import { SimulationBuilder } from '..';
 
-const test = () => SimulationBuilder.new()
-  .withSender('SP212Y5JKN59YP3GYG07K3S8W5SSGE4KH6B5STXER')
-  .inlineSimulation('1ab04a8d13d72a301b77b6af9d4f612b')
-  .addContractDeploy({
-    contract_name: 'test-simulation',
-    source_code: `
+const sender = 'SP212Y5JKN59YP3GYG07K3S8W5SSGE4KH6B5STXER';
+
+const test = () =>
+  SimulationBuilder.new()
+    .withSender(sender)
+    .addContractDeploy({
+      contract_name: 'test-simulation',
+      source_code: `
 ;; counter example
 (define-data-var counter uint u0)
 
@@ -23,24 +25,18 @@ const test = () => SimulationBuilder.new()
 (define-read-only (get-counter)
   (ok (var-get counter)))
 `,
-  })
-  .addEvalCode(
-    'SP212Y5JKN59YP3GYG07K3S8W5SSGE4KH6B5STXER.test-simulation',
-    '(get-counter)'
-  )
-  .addContractCall({
-    contract_id: 'SP212Y5JKN59YP3GYG07K3S8W5SSGE4KH6B5STXER.test-simulation',
-    function_name: 'increment',
-    function_args: [uintCV(10)],
-  })
-  .addEvalCode(
-    'SP212Y5JKN59YP3GYG07K3S8W5SSGE4KH6B5STXER.test-simulation',
-    '(get-counter)'
-  )
-  .run()
+    })
+    .addEvalCode(`${sender}.test-simulation`, '(get-counter)')
+    .addContractCall({
+      contract_id: `${sender}.test-simulation`,
+      function_name: 'increment',
+      function_args: [uintCV(10)],
+    })
+    .addEvalCode(`${sender}.test-simulation`, '(get-counter)')
+    .run();
 
 if (require.main === module) {
-  ; (async () => {
-    await test()
+  (async () => {
+    await test();
   })().catch(console.error);
-}
+}

package/src/sample/read.ts

@@ -4,11 +4,11 @@ import {
   tupleCV,
   uintCV,
 } from '@stacks/transactions';
-import { SIP010TraitABI } from 'clarity-abi/abis'
+import { SIP010TraitABI } from 'clarity-abi/abis';
+import { unwrapResponse } from 'ts-clarity';
 import { batchRead } from '../BatchAPI';
 import { BatchProcessor } from '../BatchProcessor';
 import { callReadonly, readMap, readVariable } from '../clarity-api';
-import { unwrapResponse } from 'ts-clarity';
 
 async function batchReadsExample() {
   const rs = await batchRead({
@@ -18,21 +18,21 @@ async function batchReadsExample() {
       {
         contract: contractPrincipalCV(
           'SP1Z92MPDQEWZXW36VX71Q25HKF5K2EPCJ304F275',
-          'liquidity-token-v5kbe3oqvac'
+          'liquidity-token-v5kbe3oqvac',
         ),
         variableName: 'balance-x',
       },
       {
         contract: contractPrincipalCV(
           'SP1Z92MPDQEWZXW36VX71Q25HKF5K2EPCJ304F275',
-          'liquidity-token-v5kbe3oqvac'
+          'liquidity-token-v5kbe3oqvac',
         ),
         variableName: 'balance-y',
       },
       {
         contract: contractPrincipalCV(
           'SP1Z92MPDQEWZXW36VX71Q25HKF5K2EPCJ304F275',
-          'liquidity-token-v5kbe3oqvac'
+          'liquidity-token-v5kbe3oqvac',
         ),
         variableName: 'something-not-exists',
       },
@@ -41,15 +41,15 @@ async function batchReadsExample() {
       {
         contract: contractPrincipalCV(
           'SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM',
-          'amm-registry-v2-01'
+          'amm-registry-v2-01',
         ),
         mapName: 'pools-data-map',
         mapKey: tupleCV({
           'token-x': principalCV(
-            'SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.token-wstx-v2'
+            'SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.token-wstx-v2',
           ),
           'token-y': principalCV(
-            'SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.token-alex'
+            'SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.token-alex',
           ),
           factor: uintCV(1e8),
         }),
@@ -57,7 +57,7 @@ async function batchReadsExample() {
       {
         contract: contractPrincipalCV(
           'SP1Y5YSTAHZ88XYK1VPDH24GY0HPX5J4JECTMY4A1',
-          'univ2-core'
+          'univ2-core',
         ),
         mapName: 'pools',
         mapKey: uintCV(1),
@@ -65,7 +65,7 @@ async function batchReadsExample() {
       {
         contract: contractPrincipalCV(
           'SP1Y5YSTAHZ88XYK1VPDH24GY0HPX5J4JECTMY4A1',
-          'contract-not-exists'
+          'contract-not-exists',
         ),
         mapName: 'pools',
         mapKey: uintCV(1),
@@ -81,7 +81,6 @@ async function batchQueueProcessorExample() {
     batchDelayMs: 1000,
   });
 
-
   const promiseA = processor.read({
     mode: 'variable',
     contractAddress: 'SP1Z92MPDQEWZXW36VX71Q25HKF5K2EPCJ304F275',
@@ -105,7 +104,7 @@ async function batchSip010Example() {
     abi: SIP010TraitABI.functions,
     functionName: 'get-total-supply',
     contract: 'SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.token-alex',
-  }).then(unwrapResponse)
+  }).then(unwrapResponse);
   const balance = callReadonly({
     abi: SIP010TraitABI.functions,
     functionName: 'get-balance',
@@ -113,20 +112,18 @@ async function batchSip010Example() {
     args: {
       who: 'SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.amm-vault-v2-01',
     },
-  }).then(unwrapResponse)
+  }).then(unwrapResponse);
   const paused = readVariable({
-    abi: [{ name: 'paused', type: 'bool', access: 'variable' },],
+    abi: [{ name: 'paused', type: 'bool', access: 'variable' }],
     variableName: 'paused',
     contract: 'SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.amm-vault-v2-01',
   });
   const approved = readMap({
-    abi: [
-      { key: 'principal', name: 'approved-tokens', value: 'bool' }, 
-    ],
+    abi: [{ key: 'principal', name: 'approved-tokens', value: 'bool' }],
     mapName: 'approved-tokens',
     key: 'SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.token-alex',
     contract: 'SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.amm-vault-v2-01',
-  })
+  });
   const result = await Promise.all([supply, balance, paused, approved]);
   console.log(result);
 }

package/src/simulation.ts

@@ -1,27 +1,55 @@
-import { type AccountDataResponse, getNodeInfo, richFetch } from 'ts-clarity';
-import type { Block } from '@stacks/stacks-blockchain-api-types';
 import {
+  AddressVersion,
   STACKS_MAINNET,
   STACKS_TESTNET,
   type StacksNetworkName,
 } from '@stacks/network';
+import type { Block } from '@stacks/stacks-blockchain-api-types';
 import {
+  AddressHashMode,
+  bufferCV,
   type ClarityValue,
   ClarityVersion,
-  PostConditionMode,
-  type StacksTransactionWire,
-  bufferCV,
   contractPrincipalCV,
   deserializeTransaction,
+  type MultiSigSpendingCondition,
   makeUnsignedContractCall,
   makeUnsignedContractDeploy,
   makeUnsignedSTXTokenTransfer,
+  PostConditionMode,
+  type StacksTransactionWire,
   serializeCVBytes,
   stringAsciiCV,
   tupleCV,
   uintCV,
 } from '@stacks/transactions';
 import { c32addressDecode } from 'c32check';
+import { type AccountDataResponse, getNodeInfo, richFetch } from 'ts-clarity';
+
+function setSender(tx: StacksTransactionWire, sender: string) {
+  const [addressVersion, signer] = c32addressDecode(sender);
+  switch (addressVersion) {
+    case AddressVersion.MainnetSingleSig:
+    case AddressVersion.TestnetSingleSig:
+      tx.auth.spendingCondition.hashMode = AddressHashMode.P2PKH;
+      tx.auth.spendingCondition.signer = signer;
+      break;
+    case AddressVersion.MainnetMultiSig:
+    case AddressVersion.TestnetMultiSig: {
+      const sc = tx.auth.spendingCondition;
+      tx.auth.spendingCondition = {
+        hashMode: AddressHashMode.P2SH,
+        signer,
+        fields: [],
+        signaturesRequired: 0,
+        nonce: sc.nonce,
+        fee: sc.fee,
+      } as MultiSigSpendingCondition;
+      break;
+    }
+  }
+  return tx;
+}
 
 function runTx(tx: StacksTransactionWire) {
   // type 0: run transaction
@@ -43,8 +71,8 @@ export function runEval({ contract_id, code }: SimulationEval) {
         tupleCV({
           contract: contractPrincipalCV(contract_address, contract_name),
           code: stringAsciiCV(code),
-        })
-      )
+        }),
+      ),
     ),
   });
 }
@@ -53,7 +81,7 @@ export async function runSimulation(
   apiEndpoint: string,
   block_hash: string,
   block_height: number,
-  txs: (StacksTransactionWire | SimulationEval)[]
+  txs: (StacksTransactionWire | SimulationEval)[],
 ) {
   // Convert 'sim-v1' to Uint8Array
   const header = new TextEncoder().encode('sim-v1');
@@ -73,7 +101,7 @@ export async function runSimulation(
     throw new Error('Invalid block hash format');
   }
   const hashBytes = new Uint8Array(
-    matches.map((byte) => Number.parseInt(byte, 16))
+    matches.map((byte) => Number.parseInt(byte, 16)),
   );
 
   // Convert transactions to bytes
@@ -126,46 +154,52 @@ export class SimulationBuilder {
   private network: StacksNetworkName | string;
 
   private constructor(options: SimulationBuilderOptions = {}) {
-    this.apiEndpoint = options.apiEndpoint ?? 'https://api.stxer.xyz';
-    this.stacksNodeAPI = options.stacksNodeAPI ?? 'https://api.hiro.so';
     this.network = options.network ?? 'mainnet';
+    const isTestnet = this.network === 'testnet';
+
+    this.apiEndpoint =
+      options.apiEndpoint ??
+      (isTestnet ? 'https://testnet-api.stxer.xyz' : 'https://api.stxer.xyz');
+    this.stacksNodeAPI =
+      options.stacksNodeAPI ??
+      (isTestnet ? 'https://api.testnet.hiro.so' : 'https://api.hiro.so');
   }
 
   public static new(options?: SimulationBuilderOptions) {
     return new SimulationBuilder(options);
   }
 
-  // biome-ignore lint/style/useNumberNamespace: <explanation>
+  // biome-ignore lint/style/useNumberNamespace: ignore this
   private block = NaN;
   private sender = '';
   private steps: (
     | {
-      // inline simulation
-      simulationId: string;
-    }
+        // inline simulation
+        simulationId: string;
+      }
     | {
-      // contract call
-      contract_id: string;
-      function_name: string;
-      function_args?: ClarityValue[];
-      sender: string;
-      fee: number;
-    }
+        // contract call
+        contract_id: string;
+        function_name: string;
+        function_args?: ClarityValue[];
+        sender: string;
+        fee: number;
+      }
     | {
-      // contract deploy
-      contract_name: string;
-      source_code: string;
-      deployer: string;
-      fee: number;
-      clarity_version: ClarityVersion;
-    }
+        // contract deploy
+        contract_name: string;
+        source_code: string;
+        deployer: string;
+        fee: number;
+        clarity_version: ClarityVersion;
+      }
     | {
-      // STX transfer
-      recipient: string;
-      amount: number;
-      sender: string;
-      fee: number;
-    }
+        // STX transfer
+        recipient: string;
+        amount: number;
+        sender: string;
+        fee: number;
+      }
     | SimulationEval
   )[] = [];
 
@@ -180,7 +214,7 @@ export class SimulationBuilder {
   public inlineSimulation(simulationId: string) {
     this.steps.push({
       simulationId,
-    })
+    });
     return this;
   }
   public addSTXTransfer(params: {
@@ -191,7 +225,7 @@ export class SimulationBuilder {
   }) {
     if (params.sender == null && this.sender === '') {
       throw new Error(
-        'Please specify a sender with useSender or adding a sender paramenter'
+        'Please specify a sender with useSender or adding a sender paramenter',
       );
     }
     this.steps.push({
@@ -210,7 +244,7 @@ export class SimulationBuilder {
   }) {
     if (params.sender == null && this.sender === '') {
       throw new Error(
-        'Please specify a sender with useSender or adding a sender paramenter'
+        'Please specify a sender with useSender or adding a sender paramenter',
       );
     }
     this.steps.push({
@@ -229,7 +263,7 @@ export class SimulationBuilder {
   }) {
     if (params.deployer == null && this.sender === '') {
       throw new Error(
-        'Please specify a deployer with useSender or adding a deployer paramenter'
+        'Please specify a deployer with useSender or adding a deployer paramenter',
       );
     }
     this.steps.push({
@@ -270,7 +304,7 @@ export class SimulationBuilder {
       this.block = stacks_tip_height;
     }
     const info: Block = await richFetch(
-      `${this.stacksNodeAPI}/extended/v1/block/by_height/${this.block}?unanchored=true`
+      `${this.stacksNodeAPI}/extended/v1/block/by_height/${this.block}?unanchored=true`,
     ).then((r) => r.json());
     if (
       info.height !== this.block ||
@@ -278,7 +312,7 @@ export class SimulationBuilder {
       !info.hash.startsWith('0x')
     ) {
       throw new Error(
-        `failed to get block info for block height ${this.block}`
+        `failed to get block info for block height ${this.block}`,
       );
     }
     return {
@@ -298,21 +332,22 @@ SP212Y5JKN59YP3GYG07K3S8W5SSGE4KH6B5STXER
 
 Feedbacks and feature requests are welcome.
 To get in touch: contact@stxer.xyz
---------------------------------`
+--------------------------------`,
     );
     const block = await this.getBlockInfo();
     console.log(
-      `Using block height ${block.block_height} hash 0x${block.block_hash} to run simulation.`
+      `Using block height ${block.block_height} hash 0x${block.block_hash} to run simulation.`,
     );
     const txs: (StacksTransactionWire | SimulationEval)[] = [];
     const nonce_by_address = new Map<string, number>();
     const nextNonce = async (sender: string) => {
       const nonce = nonce_by_address.get(sender);
       if (nonce == null) {
-        const url = `${this.stacksNodeAPI
-          }/v2/accounts/${sender}?proof=${false}&tip=${block.index_block_hash}`;
+        const url = `${
+          this.stacksNodeAPI
+        }/v2/accounts/${sender}?proof=${false}&tip=${block.index_block_hash}`;
         const account: AccountDataResponse = await richFetch(url).then((r) =>
-          r.json()
+          r.json(),
         );
         nonce_by_address.set(sender, account.nonce + 1);
         return account.nonce;
@@ -332,7 +367,21 @@ To get in touch: contact@stxer.xyz
     }
     for (const step of this.steps) {
       if ('simulationId' in step) {
-        const previousSimulation: {steps: ({tx: string} | {code: string, contract: string})[]} = await fetch(`https://api.stxer.xyz/simulations/${step.simulationId}/request`).then(x => x.json())
+        const previousSimulation: {
+          steps: ({ tx: string } | { code: string; contract: string })[];
+        } = await fetch(
+          `https://api.stxer.xyz/simulations/${step.simulationId}/request`,
+        ).then(async (rs) => {
+          const body = await rs.text();
+          if (!body.startsWith('{')) {
+            throw new Error(
+              `failed to get simulation ${step.simulationId}: ${body}`,
+            );
+          }
+          return JSON.parse(body) as {
+            steps: ({ tx: string } | { code: string; contract: string })[];
+          };
+        });
         for (const step of previousSimulation.steps) {
           if ('tx' in step) {
             txs.push(deserializeTransaction(step.tx));
@@ -357,7 +406,7 @@ To get in touch: contact@stxer.xyz
           postConditionMode: PostConditionMode.Allow,
           fee: step.fee,
         });
-        tx.auth.spendingCondition.signer = c32addressDecode(step.sender)[1];
+        setSender(tx, step.sender);
         txs.push(tx);
       } else if ('sender' in step && 'recipient' in step) {
         const nonce = await nextNonce(step.sender);
@@ -369,7 +418,7 @@ To get in touch: contact@stxer.xyz
           publicKey: '',
           fee: step.fee,
         });
-        tx.auth.spendingCondition.signer = c32addressDecode(step.sender)[1];
+        setSender(tx, step.sender);
         txs.push(tx);
       } else if ('deployer' in step) {
         const nonce = await nextNonce(step.deployer);
@@ -382,28 +431,29 @@ To get in touch: contact@stxer.xyz
           postConditionMode: PostConditionMode.Allow,
           fee: step.fee,
         });
-        tx.auth.spendingCondition.signer = c32addressDecode(step.deployer)[1];
+        setSender(tx, step.deployer);
         txs.push(tx);
       } else if ('code' in step) {
         txs.push(step);
       } else {
-        // biome-ignore lint/style/noUnusedTemplateLiteral: <explanation>
-        console.log(`Invalid simulation step:`, step);
+        console.log(`Invalid simulation step: ${step}`);
       }
     }
     const id = await runSimulation(
       `${this.apiEndpoint}/simulations`,
       block.block_hash,
       block.block_height,
-      txs
+      txs,
     );
     console.log(
-      `Simulation will be available at: https://stxer.xyz/simulations/${this.network}/${id}`
+      `Simulation will be available at: https://stxer.xyz/simulations/${this.network}/${id}`,
     );
     return id;
   }
 
-  public pipe(transform: (builder: SimulationBuilder) => SimulationBuilder): SimulationBuilder {
+  public pipe(
+    transform: (builder: SimulationBuilder) => SimulationBuilder,
+  ): SimulationBuilder {
     return transform(this);
   }
 }