@quantovainc/qcore 0.1.27 → 0.1.29

package/README.md

@@ -18,6 +18,8 @@ npm install @quantovainc/qcore
 ```js
 const { Client, core, generateSeed } = require('@quantovainc/qcore');
 
+const GATEWAY = 'https://rpc-testnet.quantova.org';
+
 async function main() {
   // Create an account. The seed is the only backup and it never leaves the device.
   const seed = generateSeed();
@@ -28,12 +30,39 @@ async function main() {
   const to = core.address(seed, 1n);
   console.log('from', from);
 
-  // Open a client against a node you trust. Plaintext http is allowed only to a loopback node.
-  const client = new Client('http://127.0.0.1:8645');
+  // Open a client against a node you trust. The address above is the public testnet
+  // gateway. A remote gateway must be https, plaintext http is allowed only to a loopback node.
+  const client = new Client(GATEWAY);
 
   // A fixed ceiling your app is willing to pay in fees, chosen here and never read back from the gateway.
   const MAX_FEE_QUON = '2000';
 
+  // A new account holds nothing, so take testnet funds before anything else.
+  // The faucet sends 10, 50 or 100 TQTOV to one address at a time.
+  await fetch(GATEWAY + '/faucet/api/claim', {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({ address: from, amount: 10 }),
+  });
+
+  // The faucet pays you with a transaction, so wait for the balance to arrive before spending it.
+  for (let i = 0; i < 40; i += 1) {
+    const funded = await client.account(from).catch(() => null);
+    if (funded && BigInt(funded.balance || 0) > 0n) break;
+    await new Promise((wake) => setTimeout(wake, 1500));
+  }
+
+  // An account publishes its key once before it is allowed to send. This happens a single
+  // time for each account and it pays a fee like any other transaction.
+  await client.register(seed, 0, MAX_FEE_QUON);
+
+  // Registration is itself a transaction, so wait for the key to be on chain.
+  for (let i = 0; i < 30; i += 1) {
+    const ready = await client.account(from).catch(() => null);
+    if (ready && ready.has_key) break;
+    await new Promise((wake) => setTimeout(wake, 1500));
+  }
+
   // Amounts and the ceiling are decimal strings or BigInt values, never JavaScript numbers.
   const { signed, outcome } = await client.transfer(seed, 0, to, '1000', MAX_FEE_QUON);
   console.log('submitted', signed.tx_id, outcome.verdict);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quantovainc/qcore",
-  "version": "0.1.27",
+  "version": "0.1.29",
   "description": "Quantova's post quantum client core for JavaScript. Signs with ML-DSA-65 and builds Q1 addresses.",
   "scripts": {
     "build": "bash scripts/build.sh",

package/pkg/package.json

@@ -2,7 +2,7 @@
   "name": "qcore-js",
   "type": "module",
   "description": "The JavaScript binding for the Quantova client core, generated over QCore with wasm-bindgen. The core does the key derivation, the post quantum signing, and the wire, the page does the fetch.",
-  "version": "0.1.27",
+  "version": "0.1.29",
   "license": "Apache-2.0 OR MIT",
   "repository": {
     "type": "git",

package/pkg-node/package.json

@@ -1,7 +1,7 @@
 {
   "name": "qcore-js",
   "description": "The JavaScript binding for the Quantova client core, generated over QCore with wasm-bindgen. The core does the key derivation, the post quantum signing, and the wire, the page does the fetch.",
-  "version": "0.1.27",
+  "version": "0.1.29",
   "license": "Apache-2.0 OR MIT",
   "repository": {
     "type": "git",

package/shared.js

@@ -146,7 +146,7 @@ class Network {
   static testnet() {
     return new Network({
       name: 'testnet',
-      chainId: 'Q-test-net-1',
+      chainId: 'Q-test-net-3',
       rpcUrl: 'https://rpc-testnet.quantova.org',
       explorerUrl: 'https://qvmscan.io',
       isMainnet: false,