@alephium/web3 3.0.0-test.7 → 3.0.0-test.9

package/MIGRATION.md

@@ -158,3 +158,28 @@ The following are no longer needed for `@alephium/web3` (they may still be neede
 The SDK is now built with TypeScript 5.9 and uses `moduleResolution: "bundler"` internally. Consumers using `moduleResolution: "node"` (the default) are supported via the `typesVersions` field — no changes needed on your side.
 
 If you upgrade your own project to `moduleResolution: "bundler"`, the `exports` field in `package.json` will be used for type resolution, which is more accurate.
+
+---
+
+## WalletConnect
+
+### `@alephium/walletconnect-provider` now uses `optionalNamespaces`
+
+The provider's `connect()` method now sends namespaces via `optionalNamespaces` instead of the deprecated `requiredNamespaces`. This follows WalletConnect SDK 2.21.6+, which auto-converts `requiredNamespaces` to `optionalNamespaces` internally.
+
+**If your app is a dApp (initiates WalletConnect connections):** No changes needed. The provider handles this internally.
+
+**If your app is a wallet (responds to session proposals):** Update your `session_proposal` handler to read from `optionalNamespaces`, falling back to `requiredNamespaces` for backward compatibility with older dApps:
+
+```ts
+// ❌ v2
+const { requiredNamespaces } = proposal.params
+const alephiumNamespace = requiredNamespaces['alephium']
+
+// ✅ v3
+const { requiredNamespaces, optionalNamespaces } = proposal.params
+const alephiumNamespace =
+  optionalNamespaces?.['alephium'] ?? requiredNamespaces?.['alephium']
+```
+
+This change is required because WalletConnect SDK 2.21.6+ moves all `requiredNamespaces` into `optionalNamespaces` before sending the proposal. Wallet code that only reads `requiredNamespaces` will see an empty object.

package/dist/_cjs/codec/hash.d.ts

@@ -1,3 +1,3 @@
-export declare function blakeHash(raw: Uint8Array): Uint8Array<ArrayBufferLike>;
+export declare function blakeHash(raw: Uint8Array): Uint8Array;
 export declare function djbIntHash(bytes: Uint8Array): number;
 export declare function createHint(input: Uint8Array): number;

package/dist/_cjs/codec/signature-codec.d.ts

@@ -2,4 +2,4 @@ import { ArrayCodec } from './array-codec';
 import { FixedSizeCodec } from './codec';
 export type Signature = Uint8Array;
 export declare const signatureCodec: FixedSizeCodec;
-export declare const signaturesCodec: ArrayCodec<Uint8Array<ArrayBufferLike>>;
+export declare const signaturesCodec: ArrayCodec<Uint8Array>;

package/dist/_cjs/codec/signature-codec.js.map

@@ -1 +1 @@
-{"version":3,"file":"signature-codec.js","sourceRoot":"","sources":["../../../src/codec/signature-codec.ts"],"names":[],"mappings":";;;AAiBA,+CAA0C;AAC1C,mCAAwC;AAI3B,QAAA,cAAc,GAAG,IAAI,sBAAc,CAAC,EAAE,CAAC,CAAA;AACvC,QAAA,eAAe,GAAG,IAAI,wBAAU,CAAC,sBAAc,CAAC,CAAA"}
+{"version":3,"file":"signature-codec.js","sourceRoot":"","sources":["../../../src/codec/signature-codec.ts"],"names":[],"mappings":";;;AAiBA,+CAA0C;AAC1C,mCAAwC;AAI3B,QAAA,cAAc,GAAG,IAAI,sBAAc,CAAC,EAAE,CAAC,CAAA;AACvC,QAAA,eAAe,GAA2B,IAAI,wBAAU,CAAC,sBAAc,CAAC,CAAA"}

package/dist/_cjs/codec/unlock-script-codec.d.ts

@@ -41,4 +41,4 @@ export type UnlockScript = {
     value: P2HMPK;
 };
 export declare const unlockScriptCodec: EnumCodec<UnlockScript>;
-export declare const encodedSameAsPrevious: Uint8Array<ArrayBufferLike>;
+export declare const encodedSameAsPrevious: Uint8Array;

package/dist/_cjs/codec/unlock-script-codec.js

@@ -48,5 +48,8 @@ exports.unlockScriptCodec = new codec_1.EnumCodec('unlock script', {
     P2PK: p2pkCodec,
     P2HMPK: p2hmpkCodec
 });
-exports.encodedSameAsPrevious = exports.unlockScriptCodec.encode({ kind: 'SameAsPrevious', value: 'SameAsPrevious' });
+exports.encodedSameAsPrevious = exports.unlockScriptCodec.encode({
+    kind: 'SameAsPrevious',
+    value: 'SameAsPrevious'
+});
 //# sourceMappingURL=unlock-script-codec.js.map

package/dist/_cjs/codec/unlock-script-codec.js.map

@@ -1 +1 @@
-{"version":3,"file":"unlock-script-codec.js","sourceRoot":"","sources":["../../../src/codec/unlock-script-codec.ts"],"names":[],"mappings":";;;AAiBA,+CAA0C;AAC1C,2DAA8C;AAC9C,mCAAuE;AACvE,iDAAoD;AACpD,+BAAsC;AACtC,mEAA2E;AA6B3E,MAAM,cAAc,GAAG,IAAI,sBAAc,CAAC,EAAE,CAAC,CAAA;AAC7C,MAAM,iBAAiB,GAAG,IAAI,mBAAW,CAAe;IACtD,SAAS,EAAE,cAAc;IACzB,KAAK,EAAE,4BAAQ;CAChB,CAAC,CAAA;AACF,MAAM,WAAW,GAAkB,IAAI,wBAAU,CAAC,iBAAiB,CAAC,CAAA;AACpE,MAAM,SAAS,GAAG,IAAI,mBAAW,CAAO;IACtC,MAAM,EAAE,0BAAW;IACnB,MAAM,EAAE,eAAS;CAClB,CAAC,CAAA;AACF,MAAM,mBAAmB,GAAG,IAAI,CAAC,KAAM,SAAQ,aAAqB;IAClE,MAAM;QACJ,OAAO,IAAI,UAAU,CAAC,EAAE,CAAC,CAAA;IAC3B,CAAC;IACD,OAAO;QACL,OAAO,gBAAgB,CAAA;IACzB,CAAC;CACF,CAAC,EAAE,CAAA;AACJ,MAAM,SAAS,GAAG,IAAI,CAAC,KAAM,SAAQ,aAAW;IAC9C,MAAM;QACJ,OAAO,IAAI,UAAU,CAAC,EAAE,CAAC,CAAA;IAC3B,CAAC;IACD,OAAO;QACL,OAAO,MAAM,CAAA;IACf,CAAC;CACF,CAAC,EAAE,CAAA;AAEJ,MAAM,mBAAmB,GAAG,IAAI,wBAAU,CAAC,0CAAkB,CAAC,CAAA;AAC9D,MAAM,qBAAqB,GAAG,IAAI,wBAAU,CAAC,4BAAQ,CAAC,CAAA;AACtD,MAAM,WAAW,GAAG,IAAI,mBAAW,CAAS;IAC1C,UAAU,EAAE,mBAAmB;IAC/B,gBAAgB,EAAE,qBAAqB;CACxC,CAAC,CAAA;AAEW,QAAA,iBAAiB,GAAG,IAAI,iBAAS,CAAe,eAAe,EAAE;IAC5E,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,WAAW;IACnB,IAAI,EAAE,SAAS;IACf,cAAc,EAAE,mBAAmB;IACnC,IAAI,EAAE,cAAc;IACpB,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,WAAW;CACpB,CAAC,CAAA;AAEW,QAAA,qBAAqB,GAAG,yBAAiB,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAA"}
+{"version":3,"file":"unlock-script-codec.js","sourceRoot":"","sources":["../../../src/codec/unlock-script-codec.ts"],"names":[],"mappings":";;;AAiBA,+CAA0C;AAC1C,2DAA8C;AAC9C,mCAAuE;AACvE,iDAAoD;AACpD,+BAAsC;AACtC,mEAA2E;AA6B3E,MAAM,cAAc,GAAG,IAAI,sBAAc,CAAC,EAAE,CAAC,CAAA;AAC7C,MAAM,iBAAiB,GAAG,IAAI,mBAAW,CAAe;IACtD,SAAS,EAAE,cAAc;IACzB,KAAK,EAAE,4BAAQ;CAChB,CAAC,CAAA;AACF,MAAM,WAAW,GAAkB,IAAI,wBAAU,CAAC,iBAAiB,CAAC,CAAA;AACpE,MAAM,SAAS,GAAG,IAAI,mBAAW,CAAO;IACtC,MAAM,EAAE,0BAAW;IACnB,MAAM,EAAE,eAAS;CAClB,CAAC,CAAA;AACF,MAAM,mBAAmB,GAAG,IAAI,CAAC,KAAM,SAAQ,aAAqB;IAClE,MAAM;QACJ,OAAO,IAAI,UAAU,CAAC,EAAE,CAAC,CAAA;IAC3B,CAAC;IACD,OAAO;QACL,OAAO,gBAAgB,CAAA;IACzB,CAAC;CACF,CAAC,EAAE,CAAA;AACJ,MAAM,SAAS,GAAG,IAAI,CAAC,KAAM,SAAQ,aAAW;IAC9C,MAAM;QACJ,OAAO,IAAI,UAAU,CAAC,EAAE,CAAC,CAAA;IAC3B,CAAC;IACD,OAAO;QACL,OAAO,MAAM,CAAA;IACf,CAAC;CACF,CAAC,EAAE,CAAA;AAEJ,MAAM,mBAAmB,GAAG,IAAI,wBAAU,CAAC,0CAAkB,CAAC,CAAA;AAC9D,MAAM,qBAAqB,GAAG,IAAI,wBAAU,CAAC,4BAAQ,CAAC,CAAA;AACtD,MAAM,WAAW,GAAG,IAAI,mBAAW,CAAS;IAC1C,UAAU,EAAE,mBAAmB;IAC/B,gBAAgB,EAAE,qBAAqB;CACxC,CAAC,CAAA;AAEW,QAAA,iBAAiB,GAAG,IAAI,iBAAS,CAAe,eAAe,EAAE;IAC5E,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,WAAW;IACnB,IAAI,EAAE,SAAS;IACf,cAAc,EAAE,mBAAmB;IACnC,IAAI,EAAE,cAAc;IACpB,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,WAAW;CACpB,CAAC,CAAA;AAEW,QAAA,qBAAqB,GAAe,yBAAiB,CAAC,MAAM,CAAC;IACxE,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,gBAAgB;CACxB,CAAC,CAAA"}

package/dist/_esm/codec/hash.d.ts

@@ -1,3 +1,3 @@
-export declare function blakeHash(raw: Uint8Array): Uint8Array<ArrayBufferLike>;
+export declare function blakeHash(raw: Uint8Array): Uint8Array;
 export declare function djbIntHash(bytes: Uint8Array): number;
 export declare function createHint(input: Uint8Array): number;

package/dist/_esm/codec/signature-codec.d.ts

@@ -2,4 +2,4 @@ import { ArrayCodec } from './array-codec.js';
 import { FixedSizeCodec } from './codec.js';
 export type Signature = Uint8Array;
 export declare const signatureCodec: FixedSizeCodec;
-export declare const signaturesCodec: ArrayCodec<Uint8Array<ArrayBufferLike>>;
+export declare const signaturesCodec: ArrayCodec<Uint8Array>;

package/dist/_esm/codec/signature-codec.js.map

@@ -1 +1 @@
-{"version":3,"file":"signature-codec.js","sourceRoot":"","sources":["../../../src/codec/signature-codec.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAIxC,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,EAAE,CAAC,CAAA;AACpD,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,UAAU,CAAC,cAAc,CAAC,CAAA"}
+{"version":3,"file":"signature-codec.js","sourceRoot":"","sources":["../../../src/codec/signature-codec.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAIxC,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,EAAE,CAAC,CAAA;AACpD,MAAM,CAAC,MAAM,eAAe,GAA2B,IAAI,UAAU,CAAC,cAAc,CAAC,CAAA"}

package/dist/_esm/codec/unlock-script-codec.d.ts

@@ -41,4 +41,4 @@ export type UnlockScript = {
     value: P2HMPK;
 };
 export declare const unlockScriptCodec: EnumCodec<UnlockScript>;
-export declare const encodedSameAsPrevious: Uint8Array<ArrayBufferLike>;
+export declare const encodedSameAsPrevious: Uint8Array;

package/dist/_esm/codec/unlock-script-codec.js

@@ -45,5 +45,8 @@ export const unlockScriptCodec = new EnumCodec('unlock script', {
     P2PK: p2pkCodec,
     P2HMPK: p2hmpkCodec
 });
-export const encodedSameAsPrevious = unlockScriptCodec.encode({ kind: 'SameAsPrevious', value: 'SameAsPrevious' });
+export const encodedSameAsPrevious = unlockScriptCodec.encode({
+    kind: 'SameAsPrevious',
+    value: 'SameAsPrevious'
+});
 //# sourceMappingURL=unlock-script-codec.js.map

package/dist/_esm/codec/unlock-script-codec.js.map

@@ -1 +1 @@
-{"version":3,"file":"unlock-script-codec.js","sourceRoot":"","sources":["../../../src/codec/unlock-script-codec.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACvE,OAAO,EAAU,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,EAAO,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,EAAiB,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AA6B3E,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,EAAE,CAAC,CAAA;AAC7C,MAAM,iBAAiB,GAAG,IAAI,WAAW,CAAe;IACtD,SAAS,EAAE,cAAc;IACzB,KAAK,EAAE,QAAQ;CAChB,CAAC,CAAA;AACF,MAAM,WAAW,GAAkB,IAAI,UAAU,CAAC,iBAAiB,CAAC,CAAA;AACpE,MAAM,SAAS,GAAG,IAAI,WAAW,CAAO;IACtC,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,SAAS;CAClB,CAAC,CAAA;AACF,MAAM,mBAAmB,GAAG,IAAI,CAAC,KAAM,SAAQ,KAAqB;IAClE,MAAM;QACJ,OAAO,IAAI,UAAU,CAAC,EAAE,CAAC,CAAA;IAC3B,CAAC;IACD,OAAO;QACL,OAAO,gBAAgB,CAAA;IACzB,CAAC;CACF,CAAC,EAAE,CAAA;AACJ,MAAM,SAAS,GAAG,IAAI,CAAC,KAAM,SAAQ,KAAW;IAC9C,MAAM;QACJ,OAAO,IAAI,UAAU,CAAC,EAAE,CAAC,CAAA;IAC3B,CAAC;IACD,OAAO;QACL,OAAO,MAAM,CAAA;IACf,CAAC;CACF,CAAC,EAAE,CAAA;AAEJ,MAAM,mBAAmB,GAAG,IAAI,UAAU,CAAC,kBAAkB,CAAC,CAAA;AAC9D,MAAM,qBAAqB,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAA;AACtD,MAAM,WAAW,GAAG,IAAI,WAAW,CAAS;IAC1C,UAAU,EAAE,mBAAmB;IAC/B,gBAAgB,EAAE,qBAAqB;CACxC,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,SAAS,CAAe,eAAe,EAAE;IAC5E,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,WAAW;IACnB,IAAI,EAAE,SAAS;IACf,cAAc,EAAE,mBAAmB;IACnC,IAAI,EAAE,cAAc;IACpB,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,WAAW;CACpB,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,iBAAiB,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAA"}
+{"version":3,"file":"unlock-script-codec.js","sourceRoot":"","sources":["../../../src/codec/unlock-script-codec.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACvE,OAAO,EAAU,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,EAAO,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,EAAiB,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AA6B3E,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,EAAE,CAAC,CAAA;AAC7C,MAAM,iBAAiB,GAAG,IAAI,WAAW,CAAe;IACtD,SAAS,EAAE,cAAc;IACzB,KAAK,EAAE,QAAQ;CAChB,CAAC,CAAA;AACF,MAAM,WAAW,GAAkB,IAAI,UAAU,CAAC,iBAAiB,CAAC,CAAA;AACpE,MAAM,SAAS,GAAG,IAAI,WAAW,CAAO;IACtC,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,SAAS;CAClB,CAAC,CAAA;AACF,MAAM,mBAAmB,GAAG,IAAI,CAAC,KAAM,SAAQ,KAAqB;IAClE,MAAM;QACJ,OAAO,IAAI,UAAU,CAAC,EAAE,CAAC,CAAA;IAC3B,CAAC;IACD,OAAO;QACL,OAAO,gBAAgB,CAAA;IACzB,CAAC;CACF,CAAC,EAAE,CAAA;AACJ,MAAM,SAAS,GAAG,IAAI,CAAC,KAAM,SAAQ,KAAW;IAC9C,MAAM;QACJ,OAAO,IAAI,UAAU,CAAC,EAAE,CAAC,CAAA;IAC3B,CAAC;IACD,OAAO;QACL,OAAO,MAAM,CAAA;IACf,CAAC;CACF,CAAC,EAAE,CAAA;AAEJ,MAAM,mBAAmB,GAAG,IAAI,UAAU,CAAC,kBAAkB,CAAC,CAAA;AAC9D,MAAM,qBAAqB,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAA;AACtD,MAAM,WAAW,GAAG,IAAI,WAAW,CAAS;IAC1C,UAAU,EAAE,mBAAmB;IAC/B,gBAAgB,EAAE,qBAAqB;CACxC,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,SAAS,CAAe,eAAe,EAAE;IAC5E,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,WAAW;IACnB,IAAI,EAAE,SAAS;IACf,cAAc,EAAE,mBAAmB;IACnC,IAAI,EAAE,cAAc;IACpB,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,WAAW;CACpB,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAe,iBAAiB,CAAC,MAAM,CAAC;IACxE,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,gBAAgB;CACxB,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alephium/web3",
-  "version": "3.0.0-test.7",
+  "version": "3.0.0-test.9",
   "description": "A JS/TS library to interact with the Alephium platform",
   "license": "GPL",
   "type": "commonjs",
@@ -67,7 +67,7 @@
     "@noble/curves": "1.9.7",
     "@noble/hashes": "1.8.0",
     "@noble/secp256k1": "1.7.2",
-    "base-x": "4.0.0",
+    "base-x": "4.0.1",
     "bignumber.js": "^9.1.1",
     "eventemitter3": "^4.0.7"
   },
@@ -89,10 +89,11 @@
     "shelljs": "^0.8.5",
     "size-limit": "^11.0.0",
     "swagger-typescript-api": "12.0.3",
-    "ts-node": "^10.9.1",
+    "ts-node": "^10.9.2",
     "tsc-alias": "^1.8.16",
     "tslib": "^2.5.0",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vitest": "^3.1.1"
   },
   "engines": {
     "node": ">=20.0.0",

package/src/codec/hash.ts

@@ -17,7 +17,7 @@ along with the library. If not, see <http://www.gnu.org/licenses/>.
 */
 import { blake2b } from '@noble/hashes/blake2b'
 
-export function blakeHash(raw: Uint8Array) {
+export function blakeHash(raw: Uint8Array): Uint8Array {
   return blake2b(raw, { dkLen: 32 })
 }
 

package/src/codec/signature-codec.ts

@@ -21,4 +21,4 @@ import { FixedSizeCodec } from './codec'
 export type Signature = Uint8Array
 
 export const signatureCodec = new FixedSizeCodec(64)
-export const signaturesCodec = new ArrayCodec(signatureCodec)
+export const signaturesCodec: ArrayCodec<Uint8Array> = new ArrayCodec(signatureCodec)

package/src/codec/unlock-script-codec.ts

@@ -93,4 +93,7 @@ export const unlockScriptCodec = new EnumCodec<UnlockScript>('unlock script', {
   P2HMPK: p2hmpkCodec
 })
 
-export const encodedSameAsPrevious = unlockScriptCodec.encode({ kind: 'SameAsPrevious', value: 'SameAsPrevious' })
+export const encodedSameAsPrevious: Uint8Array = unlockScriptCodec.encode({
+  kind: 'SameAsPrevious',
+  value: 'SameAsPrevious'
+})