0.0.10-alpha

Signed-off-by: T-Hax <>
2023-05-11 19:41:44 +00:00 · 2023-05-11 19:41:44 +00:00 · 35ea8d2d14
commit 35ea8d2d14
parent 798598cfff
15 changed files with 157 additions and 113 deletions
--- a/.yarn/versions/6944eba2.yml
+++ b/.yarn/versions/6944eba2.yml
@ -0,0 +1,8 @@
+undecided:
+  - "@tornado/sdk-monorepo"
+  - "@tornado/sdk-chain"
+  - "@tornado/sdk-core"
+  - "@tornado/sdk-crypto"
+  - "@tornado/sdk-data"
+  - "@tornado/sdk-utils"
+  - "@tornado/sdk-web"
--- a/@tornado/sdk-chain/package.json
+++ b/@tornado/sdk-chain/package.json
@ -13,7 +13,7 @@
    "crypto",
    "zk"
  ],
-  "version": "0.0.8-alpha",
+  "version": "0.0.9-alpha",
  "engines": {
    "node": "^18"
  },
@ -80,5 +80,6 @@
    "tsconfig-paths@4.2.0": {
      "unplugged": true
    }
-  }
+  },
+  "stableVersion": "0.0.8-alpha"
 }
--- a/@tornado/sdk-core/package.json
+++ b/@tornado/sdk-core/package.json
@ -13,7 +13,7 @@
    "crypto",
    "zk"
  ],
-  "version": "0.0.8-alpha",
+  "version": "0.0.10-alpha",
  "engines": {
    "node": "^18"
  },
@ -83,5 +83,6 @@
    "tsconfig-paths@4.2.0": {
      "unplugged": true
    }
-  }
+  },
+  "stableVersion": "0.0.8-alpha"
 }
--- a/@tornado/sdk-core/src/index.ts
+++ b/@tornado/sdk-core/src/index.ts
@ -147,12 +147,9 @@ export class Core extends Synchronizer {
  }

  private _checkProvider(parentCallName: string): void {
-    try {
-      this._chain?.id
-    } catch (err) {
+    if (!this._chain)
      throw ErrorUtils.getError('Core.' + parentCallName + ': you must first connect a provider!')
  }
-  }

  async connect(provider: Provider): Promise<void> {
    if (!this._chain) this._chain = new Chain(provider)
@ -161,12 +158,14 @@ export class Core extends Synchronizer {
  }

  getInstances(keys: Array<{ token: string; denomination: number | string }>): Array<TornadoInstance> {
+    this._checkProvider('getInstances')
    return keys.map((key) =>
      Contracts.getInstance(String(this.chain.id), key.token, String(key.denomination), this.chain.provider)
    )
  }

  getInstance(token: string, denomination: number | string): TornadoInstance {
+    this._checkProvider('getInstance')
    return this.loadInstance(this.chain.id, token, denomination)
  }

@ -591,6 +590,8 @@ export class Core extends Synchronizer {
    instances: Array<TornadoInstance>,
    options?: Options.Core.Deposit
  ): Array<Transactions.Deposit> {
+    this._checkProvider('buildDepositTransactions')
+
    const depositsPerInstance = options?.depositsPerInstance ?? new Array<number>(instances.length).fill(1)

    const doNotPopulate = options?.doNotPopulate ?? false
--- a/@tornado/sdk-crypto/package.json
+++ b/@tornado/sdk-crypto/package.json
@ -13,7 +13,7 @@
    "crypto",
    "zk"
  ],
-  "version": "0.0.8-alpha",
+  "version": "0.0.9-alpha",
  "engines": {
    "node": "^18"
  },
@ -75,5 +75,6 @@
    "tsconfig-paths@4.2.0": {
      "unplugged": true
    }
-  }
+  },
+  "stableVersion": "0.0.8-alpha"
 }
--- a/@tornado/sdk-data/package.json
+++ b/@tornado/sdk-data/package.json
@ -13,7 +13,7 @@
    "crypto",
    "zk"
  ],
-  "version": "0.0.8-alpha",
+  "version": "0.0.9-alpha",
  "engines": {
    "node": "^18"
  },
@ -79,5 +79,6 @@
    "tsconfig-paths@4.2.0": {
      "unplugged": true
    }
-  }
+  },
+  "stableVersion": "0.0.8-alpha"
 }
--- a/@tornado/sdk-utils/package.json
+++ b/@tornado/sdk-utils/package.json
@ -13,7 +13,7 @@
    "crypto",
    "zk"
  ],
-  "version": "0.0.8-alpha",
+  "version": "0.0.9-alpha",
  "engines": {
    "node": "^18"
  },
@ -68,5 +68,6 @@
    "tsconfig-paths@4.2.0": {
      "unplugged": true
    }
-  }
+  },
+  "stableVersion": "0.0.8-alpha"
 }
--- a/@tornado/sdk-web/package.json
+++ b/@tornado/sdk-web/package.json
@ -13,7 +13,7 @@
    "crypto",
    "zk"
  ],
-  "version": "0.0.8-alpha",
+  "version": "0.0.9-alpha",
  "engines": {
    "node": "^18"
  },
@ -76,5 +76,6 @@
    "tsconfig-paths@4.2.0": {
      "unplugged": true
    }
-  }
+  },
+  "stableVersion": "0.0.8-alpha"
 }
--- a/@tornado/sdk/package.json
+++ b/@tornado/sdk/package.json
@ -13,7 +13,7 @@
    "crypto",
    "zk"
  ],
-  "version": "0.0.8-alpha",
+  "version": "0.0.10-alpha",
  "engines": {
    "node": "^18"
  },
@ -61,5 +61,6 @@
    "tsconfig-paths@4.2.0": {
      "unplugged": true
    }
-  }
+  },
+  "stableVersion": "0.0.8-alpha"
 }
--- a/README.md
+++ b/README.md
@ -2,7 +2,9 @@

 SDK to integrate your protocol with Tornado Cash.

-[Check out the docs here.](./docs/ABOUT.md)
+[Please check out the docs here.](./docs/ABOUT.md)
+
+You SHOULD familiarize yourself with features [still considered experimental](./docs/EXPERIMENTAL.md).

 You may also read, [a note on testing.](./docs/TESTS.md)

--- a/docs/ABOUT.md
+++ b/docs/ABOUT.md
@ -1,7 +1,8 @@
 # Tornado Cash SDK

-A collection of Typescript packages which enable you to easily use the Tornado Cash protocol.
+A collection of Typescript packages which enable you to easily use the Tornado Cash protocol. Please note that you should familiarize yourself with any still experimental functions, this will be the first link below.

+* [Experimental features](./EXPERIMENTAL.md)
 * [Installation](./INSTALLATION.md)
 * [Usage](./USAGE.md)

--- a/docs/EXPERIMENTAL.md
+++ b/docs/EXPERIMENTAL.md
@ -0,0 +1,9 @@
+# Functions which are still considered experimental
+
+Ranked by danger.
+
+* **Core.buildDepositProof(s)** ➡️ because we still need more testnet tests. Nominally, should work though. Use at own risk. Very very likely won't break.
+
+* **Relayer.handleWithdrawal** ➡️ because no test relayer has been yet available to handle this. Will likely break.
+
+* **Core.loadNotes** ➡️ more tests are needed on filtering behaviour. Likely won't break.
--- a/docs/USAGE.md
+++ b/docs/USAGE.md
@ -4,12 +4,16 @@

 ```ts
 import * as Tornado from "@tornado/sdk"
+import { providers } from "ethers"

 async function main() {
    // Get the core Tornado Cash logic.
    const core = new Tornado.Core()

-    // Build tx
+    // Connect a provider
+    await core.connect(new providers.JsonRpcProvider("https://some.rpc.url"))
+
+    // Build tx (synchronous)
    const tx = core.buildDepositTransaction(core.getInstance("usdc", "100"))

    // Print the tx to console
@ -21,8 +25,11 @@ main()

 ### Build a withdrawal transaction

+This is _still_ considered experimental, I will flag it as _not experimental_ after a certain number of production tests.
+
 ```ts
 import * as Tornado from "@tornado/sdk"
+import { providers, BigNumber } from "ethers"

 async function main() {
  // The address to receive the funds...
@ -32,14 +39,14 @@ async function main() {
  const core = new Tornado.Core()

  // Get a regular ethers v5 provider.
-    const provider = new providers.JsonRpcProvider("ENTER YOUR RPC URL HERE!")
+  const provider = new providers.JsonRpcProvider("https://some.rpc.url")

  // This time we need to connect the provider
  await core.connect(provider)

  // We also need a relayer
  const relayer = new Tornado.Web.Relayer({
-      url: "https://" + "ENTER YOUR CHOSEN RELAYER DOMAIN HERE",
+    url: "https://" + "some.relayer.org",
    // Web can also instead provide a TorHttpClient or an (ethers v5) TorProvider
    httpClient: new Tornado.Web.RegularHttpClient()
  })
@ -56,19 +63,20 @@ async function main() {
  // In our case we've set indexes to undefined and choosing our notes according to the instance
  // And then selecting the first one of those
  const note = (await core.loadNotes(undefined, {
-      network: core.chain.id,
+    network: '' + core.chain.id,
    token: "eth",
    denomination: "0.1"
  }))[0]

  // Now build the proof
  const proof = await core.buildDepositProof(instance, relayer.properties, receiverAddress, note, {
-          // Defaults
+    // Defaults after the function populates as a showcase
+    // You can also leave all of this out and it will set it by itself
    checkNotesSpent: true,
    checkKnownRoot: true,
    merkleTreeHeight: 20,
    tokenDecimals: 18,
-          ethPurchaseAmounts: [BigNumber.from(0)],
+    ethPurchaseAmounts: [BigNumber.from(0)], // When doing multiple proofs, more elements in array
    gasPrice: undefined,
    gasPriceCushion: undefined,
  })
@ -82,12 +90,12 @@ main()
 ### Synchronize Deposit Events Over Clearnet Without Sync Logs

 ```ts
-import { providers } from "ethers"
 import * as Tornado from "@tornado/sdk"
+import { providers } from "ethers"

 async function sync() {
  // Get a regular ethers v5 provider.
-    const provider = new providers.JsonRpcProvider("ENTER YOUR RPC URL HERE!")
+  const provider = new providers.JsonRpcProvider("https://some.rpc.url")

  // Get the core Tornado Cash logic.
  const core = new Tornado.Core()
@ -104,6 +112,8 @@ async function sync() {
  // Now export it as an archive!
  await core.exportAsArchive('Deposits1ETH0.1')
 }
+
+sync()
 ```

 ### Synchronize Deposit Events Over Tor Without Sync Logs
@ -114,7 +124,7 @@ import * as Tornado from "@tornado/sdk"
 async function sync() {
  // Get a torified ethers v5 provider.
  // You can set the port to 9150 if you use Tor Browser!
-    const provider = new Tornado.Web.TorProvider("ENTER YOUR RPC URL HERE!", { port: 9050 })
+  const provider = new Tornado.Web.TorProvider("https://some.rpc.url", { port: 9050 })

  // Get the core Tornado Cash logic.
  const core = new Tornado.Core()
@ -123,7 +133,7 @@ async function sync() {
  await core.connect(provider)

  // Get the instance to sync
-    const instance = await core.getInstance("eth", 0.1)
+  const instance = core.getInstance("eth", 0.1)

  // Sync!
  await core.syncDeposits(instance,
@ -147,8 +157,7 @@ sync()
 ```ts
 import * as Tornado from "@tornado/sdk"

-/// You can implement this however you want.
-function logListener(...args: any[]) {
+let logListener = function (...args: any[]) {
  if (args.length === 3) {
    console.debug(`\nSync will be started with SB: ${args[0]}, TB: ${args[1]}, BD: ${args[2]}\n`)
  } else if (args.length == 2) {
@ -167,13 +176,18 @@ async function sync() {
  await core.connect(provider)

  // Get the instance to sync
-    const instance = await core.getInstance("eth", 0.1)
+  const instance = core.getInstance("eth", 0.1)

  // Log
  core.on('debug', logListener)

  // Sync!
-    await core.syncDeposits(instance)
+  await core.syncDeposits(instance,
+    {
+      // Always sync from start if we want to do multiple RPCs
+      startBlock: Tornado.Data.Onchain.getInstanceDeployBlockNumSync("1", "eth", "0.1")
+    }
+  )

  // Log
  core.off('debug', logListener)
--- a/docs/api/index.html
+++ b/docs/api/index.html
@ -13,7 +13,8 @@
 <div class="tsd-page-title">
 <h2>@tornado/sdk</h2></div>
 <div class="tsd-panel tsd-typography"><a id="md:tornado-cash-sdk" class="tsd-anchor"></a><h1><a href="#md:tornado-cash-sdk">Tornado Cash SDK</a></h1><p>SDK to integrate your protocol with Tornado Cash.</p>
-<p><a href="./docs/ABOUT.md">Check out the docs here.</a></p>
+<p><a href="./docs/ABOUT.md">Please check out the docs here.</a></p>
+<p>You SHOULD familiarize yourself with features <a href="./docs/EXPERIMENTAL.md">still considered experimental</a>.</p>
 <p>You may also read, <a href="./docs/TESTS.md">a note on testing.</a></p>
 <p>Contributions are welcome, we are here for freedom after all!</p>
 <p>See <a href="./HISTORY.md">HISTORY.md</a> for a development log.</p>
--- a/package.json
+++ b/package.json
@ -10,7 +10,7 @@
    "crypto",
    "zk"
  ],
-  "version": "0.0.8-alpha",
+  "version": "0.0.9-alpha",
  "engines": {
    "node": "^18"
  },
@ -104,5 +104,6 @@
    "tsconfig-paths@4.2.0": {
      "unplugged": true
    }
-  }
+  },
+  "stableVersion": "0.0.8-alpha"
 }