feat: ink contract events (#843)

Co-authored-by: Harry Solovay <harrysolovay@users.noreply.github.com>
Co-authored-by: Harry Solovay <harrysolovay@gmail.com>
Co-authored-by: T6 <t6@t6.fyi>

cspell.json

@@ -13,11 +13,10 @@
   ],
   "ignorePaths": [
     "**/*.wasm",
-    "frame_metadata/raw_erc20_metadata.json",
     "target",
     "**/__snapshots__/*.snap",
     "**/*.contract",
-    "examples/smart_contract/metadata.json",
+    "examples/ink/erc20.json",
     "**/*.scale"
   ]
 }

dprint.json

@@ -14,7 +14,11 @@
   "includes": [
     "**.{dockerfile,json,md,toml,ts,tsx}"
   ],
-  "excludes": ["target", "util/_artifacts"],
+  "excludes": [
+    "target",
+    "util/_artifacts",
+    "examples/ink/erc20.json"
+  ],
   "plugins": [
     "https://plugins.dprint.dev/dockerfile-0.3.0.wasm",
     "https://plugins.dprint.dev/json-0.17.0.wasm",

examples/ink/TODO.md

@@ -0,0 +1,6 @@
+# TODO
+
+Determine a way to _cleanly_ share data (instantiator, contract address) between
+ink example envs without necessarily merging the examples. Aka., one should be
+able to run them independently / supply an alternative contract and user address
+to interaction examples.

examples/ink/deploy.eg.ts

@@ -2,9 +2,9 @@
  * @title Deploy an Ink Smart Contract
  * @stability unstable – We intend to work on an Ink provider (for static codegen)
  * in the near future. This work will likely entail large changes to the current ink patterns.
- *
- * Deploying an Ink contract (instantiating) to a production contracts-enabled parachain
+ * @description Deploying an Ink contract (instantiating) to a production contracts-enabled parachain
  * is much the same as any other extrinsic submission.
+ * @todo utilize `createUsers` instead of `alice`
  */
 
 import { $, alice, ss58 } from "capi"
@@ -14,15 +14,16 @@ import { chain, System } from "contracts_dev/mod.js"
 
 // Initialize an `InkMetadataRune` with the raw Ink metadata text.
 const metadata = InkMetadataRune.fromMetadataText(
-  Deno.readTextFileSync(new URL(import.meta.resolve("./metadata.json"))),
+  Deno.readTextFileSync(new URL(import.meta.resolve("./erc20.json"))),
 )
 
 // Instantiate `code.wasm` with `alice` and––upon block inclusion––return the
 // list of system events specific to this instantiation.
 const events = await metadata
   .instantiation(chain, {
     sender: alice.publicKey,
-    code: Deno.readFileSync(new URL("./code.wasm", import.meta.url)),
+    code: Deno.readFileSync(new URL("./erc20.wasm", import.meta.url)),
+    args: [1_000_000n],
   })
   .signed(signature({ sender: alice }))
   .sent()
@@ -39,10 +40,10 @@ const events = await metadata
 for (const { event } of events) {
   if (event.type === "Contracts" && event.value.type === "Instantiated") {
     const accountId = event.value.contract
-    console.log("account id:", accountId)
+    console.log("Account id:", accountId)
     $.assert($.sizedUint8Array(32), accountId)
     const address = ss58.encode(System.SS58Prefix, accountId)
-    console.log("ss58 address:", address)
+    console.log("Contract ss58 address:", address)
     Deno.env.set("SS58_ADDRESS", address)
     break
   }