@openrai/nano-core 2.3.1 → 2.4.2

package/README.md

@@ -21,30 +21,36 @@ npm install @openrai/nano-core
 ## 🛠 Quick Start
 
 ### 1. Minimal Client
-The default surface should feel obvious on first read:
+`nano-core` handles endpoint selection, auth redaction, and precision-safe math so you can focus on the task at hand:
 
 ```typescript
-import { NanoClient } from '@openrai/nano-core';
+import { NanoClient, NanoAddress, NanoAmount } from '@openrai/nano-core';
 
-const client = NanoClient.initialize({
-  rpc: [
-    'https://rpc.primary.example.com?apiKey=secret-rpc',
-    'https://rpc.nano.to',
-  ], // [Optional] Defaults to the April 2026 public RPC set
-  ws: [
-    'wss://ws.primary.example.com?api_key=secret-ws',
-    'wss://rpc.nano.to',
-  ], // [Optional] Defaults to public WebSocket endpoints
-  work: [
-    'https://work.primary.example.com?key=secret-work',
-    'https://rpc.nano.to',
-  ], // [Optional] Defaults to `https://rpc.nano.to` as the current public work endpoint
-  warn: (message) => console.warn(message), // [Optional] Defaults to console.warn with nano-core prefix
-});
+// Start with built-in public endpoints — no config required
+const client = NanoClient.initialize();
+
+// Validate a destination address (checksum-verified, throws on bad input)
+const destination = NanoAddress.parse(
+  'nano_3arg3asgtigae3xckabaaewkx3bzsh7nwz7jkmjos79ihyaxwphhm6qgjps4',
+);
+
+// Express value in human-readable NANO — stored as precision-safe raw internally
+const amount = NanoAmount.fromNano('1.25');
 
-console.log(client.getAuditReport());
+// Hydrate a wallet from a seed (keep your seed in an env var, never hard-code it)
+const wallet = await client.hydrateWallet(process.env.NANO_SEED!, { index: 0 });
+const hash = await wallet.send(destination, amount);
+
+console.log(`Sent ${amount} NANO → ${destination}`);
+console.log(`Block hash: ${hash}`);
 ```
 
+Under the hood, `nano-core` has already:
+- Selected a live RPC from the built-in April 2026 public pool
+- Validated the address checksum and derived the public key
+- Stored `1.25 NANO` as `1250000000000000000000000000000` raw — no float drift
+- Redacted any API keys from audit output
+
 ### 1.1 Observe Endpoint Selection
 
 Long-running services can observe which upstream endpoint became active without

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { NanoAddress } from './primitives/NanoAddress.js';
 export { NanoAmount } from './primitives/NanoAmount.js';
+export { NOMS } from './signing/noms.js';
 export { WorkProvider, RemoteWorkServer, LocalCompute, type WorkProviderOptions } from './work/WorkProvider.js';
 export { NanoClient, TransportFallback, type NanoClientOptions, type NanoClientActiveEndpoints, type NanoClientAuditReport } from './client.js';
 export { EndpointPool, HttpEndpointPool, NanoTransportConfigError, WsEndpointPool, normalizeEndpoints, } from './transport/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAChH,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,KAAK,yBAAyB,EAAE,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAChJ,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,cAAc,EACd,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,UAAU,EACV,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,eAAe,GAChB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAChH,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,KAAK,yBAAyB,EAAE,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAChJ,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,cAAc,EACd,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,UAAU,EACV,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,eAAe,GAChB,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export { NanoAddress } from './primitives/NanoAddress.js';
 export { NanoAmount } from './primitives/NanoAmount.js';
+export { NOMS } from './signing/noms.js';
 export { WorkProvider, RemoteWorkServer, LocalCompute } from './work/WorkProvider.js';
 export { NanoClient, TransportFallback } from './client.js';
 export { EndpointPool, HttpEndpointPool, NanoTransportConfigError, WsEndpointPool, normalizeEndpoints, } from './transport/index.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAA4B,MAAM,wBAAwB,CAAC;AAChH,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAsF,MAAM,aAAa,CAAC;AAChJ,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,cAAc,EACd,kBAAkB,GACnB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAA4B,MAAM,wBAAwB,CAAC;AAChH,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAsF,MAAM,aAAa,CAAC;AAChJ,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,cAAc,EACd,kBAAkB,GACnB,MAAM,sBAAsB,CAAC"}

package/dist/signing/noms.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Nano Off-chain Message Signing (NOMS) implementation (ORIS-001).
+ */
+export declare const NOMS: {
+    /**
+     * Constructs the binary payload for an off-chain message as per ORIS-001.
+     * Format: MAGIC_HEADER (25 bytes) || MESSAGE_LENGTH (4 bytes uint32be) || MESSAGE (UTF-8)
+     */
+    createPayload(message: string): Uint8Array;
+    /**
+     * Computes the 32-byte Blake2b hash of the NOMS payload.
+     */
+    hashMessage(message: string): string;
+    /**
+     * Signs an off-chain message using standard Nano Ed25519 behavior.
+     * @param message The UTF-8 string message to sign.
+     * @param secretKey The 32-byte private key in hexadecimal format.
+     * @returns The 64-byte signature in hexadecimal format (128 characters).
+     */
+    signMessage(message: string, secretKey: string): string;
+    /**
+     * Verifies an off-chain message signature against a public key.
+     * @param message The UTF-8 string message that was signed.
+     * @param signature The 64-byte signature in hexadecimal format.
+     * @param publicKey The 32-byte public key in hexadecimal format.
+     * @returns True if the signature is valid for the given message and public key.
+     */
+    verifyMessage(message: string, signature: string, publicKey: string): boolean;
+};
+//# sourceMappingURL=noms.d.ts.map

package/dist/signing/noms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noms.d.ts","sourceRoot":"","sources":["../../src/signing/noms.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,eAAO,MAAM,IAAI;IACf;;;OAGG;2BACoB,MAAM,GAAG,UAAU;IAa1C;;OAEG;yBACkB,MAAM,GAAG,MAAM;IAKpC;;;;;OAKG;yBACkB,MAAM,aAAa,MAAM,GAAG,MAAM;IAKvD;;;;;;OAMG;2BACoB,MAAM,aAAa,MAAM,aAAa,MAAM,GAAG,OAAO;CAI9E,CAAC"}

package/dist/signing/noms.js

@@ -0,0 +1,53 @@
+import blake from 'blakejs';
+import * as nanocurrency from 'nanocurrency';
+const { blake2bHex } = blake;
+const MAGIC_HEADER_TEXT = '\x18Nano Off-chain Message:\n';
+const MAGIC_HEADER_BYTES = new TextEncoder().encode(MAGIC_HEADER_TEXT);
+/**
+ * Nano Off-chain Message Signing (NOMS) implementation (ORIS-001).
+ */
+export const NOMS = {
+    /**
+     * Constructs the binary payload for an off-chain message as per ORIS-001.
+     * Format: MAGIC_HEADER (25 bytes) || MESSAGE_LENGTH (4 bytes uint32be) || MESSAGE (UTF-8)
+     */
+    createPayload(message) {
+        const messageBytes = new TextEncoder().encode(message);
+        const lengthBytes = new Uint8Array(4);
+        new DataView(lengthBytes.buffer).setUint32(0, messageBytes.length, false);
+        const payload = new Uint8Array(MAGIC_HEADER_BYTES.length + lengthBytes.length + messageBytes.length);
+        payload.set(MAGIC_HEADER_BYTES, 0);
+        payload.set(lengthBytes, MAGIC_HEADER_BYTES.length);
+        payload.set(messageBytes, MAGIC_HEADER_BYTES.length + lengthBytes.length);
+        return payload;
+    },
+    /**
+     * Computes the 32-byte Blake2b hash of the NOMS payload.
+     */
+    hashMessage(message) {
+        const payload = this.createPayload(message);
+        return blake2bHex(payload, undefined, 32);
+    },
+    /**
+     * Signs an off-chain message using standard Nano Ed25519 behavior.
+     * @param message The UTF-8 string message to sign.
+     * @param secretKey The 32-byte private key in hexadecimal format.
+     * @returns The 64-byte signature in hexadecimal format (128 characters).
+     */
+    signMessage(message, secretKey) {
+        const hash = this.hashMessage(message);
+        return nanocurrency.signBlock({ hash, secretKey }).toLowerCase();
+    },
+    /**
+     * Verifies an off-chain message signature against a public key.
+     * @param message The UTF-8 string message that was signed.
+     * @param signature The 64-byte signature in hexadecimal format.
+     * @param publicKey The 32-byte public key in hexadecimal format.
+     * @returns True if the signature is valid for the given message and public key.
+     */
+    verifyMessage(message, signature, publicKey) {
+        const hash = this.hashMessage(message);
+        return nanocurrency.verifyBlock({ hash, signature, publicKey });
+    },
+};
+//# sourceMappingURL=noms.js.map

package/dist/signing/noms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noms.js","sourceRoot":"","sources":["../../src/signing/noms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,SAAS,CAAC;AAC5B,OAAO,KAAK,YAAY,MAAM,cAAc,CAAC;AAE7C,MAAM,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;AAE7B,MAAM,iBAAiB,GAAG,+BAA+B,CAAC;AAC1D,MAAM,kBAAkB,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAEvE;;GAEG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB;;;OAGG;IACH,aAAa,CAAC,OAAe;QAC3B,MAAM,YAAY,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACvD,MAAM,WAAW,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;QACtC,IAAI,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAE1E,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,kBAAkB,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QACrG,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,kBAAkB,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QAE1E,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,OAAe;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC5C,OAAO,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,OAAe,EAAE,SAAiB;QAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO,YAAY,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACnE,CAAC;IAED;;;;;;OAMG;IACH,aAAa,CAAC,OAAe,EAAE,SAAiB,EAAE,SAAiB;QACjE,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO,YAAY,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;IAClE,CAAC;CACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrai/nano-core",
-  "version": "2.3.1",
+  "version": "2.4.2",
   "description": "Protocol engine for Nano integration ecosystem",
   "repository": "https://github.com/OpenRai/nano-core",
   "type": "module",
@@ -43,7 +43,8 @@
     "dist"
   ],
   "dependencies": {
-    "nano-pow-with-fallback": "^1.1.2",
+    "blakejs": "^1.2.1",
+    "nano-pow-with-fallback": "github:cbrunnkvist/nano-pow-with-fallback#v1.2.1",
     "nanocurrency": "^2.5.0"
   },
   "devDependencies": {