@canton-network/core-wallet-discovery 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/client.d.ts +61 -0
- package/dist/client.d.ts.map +1 -0
- package/dist/errors.d.ts +25 -0
- package/dist/errors.d.ts.map +1 -0
- package/dist/events.d.ts +27 -0
- package/dist/events.d.ts.map +1 -0
- package/dist/index.cjs +255 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.ts +6 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +245 -0
- package/dist/index.js.map +1 -0
- package/dist/storage.d.ts +7 -0
- package/dist/storage.d.ts.map +1 -0
- package/dist/types.d.ts +59 -0
- package/dist/types.d.ts.map +1 -0
- package/package.json +45 -0
package/dist/client.d.ts
ADDED
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
import type { Provider } from '@canton-network/core-splice-provider';
|
|
2
|
+
import type { ProviderId, RpcTypes as DappRpcTypes } from '@canton-network/core-wallet-dapp-rpc-client';
|
|
3
|
+
import type { ProviderAdapter, WalletInfo, WalletPickerFn } from './types';
|
|
4
|
+
import { type DiscoveryClientEventName, type DiscoveryClientEventHandler } from './events';
|
|
5
|
+
export interface DiscoveryClientConfig {
|
|
6
|
+
/** Adapters to register on init. */
|
|
7
|
+
adapters?: ProviderAdapter[] | undefined;
|
|
8
|
+
/**
|
|
9
|
+
* A function that presents wallet choices to the user and returns their selection.
|
|
10
|
+
* When not provided, `connect()` requires a `providerId` argument.
|
|
11
|
+
*/
|
|
12
|
+
walletPicker?: WalletPickerFn | undefined;
|
|
13
|
+
}
|
|
14
|
+
export interface ActiveSession {
|
|
15
|
+
providerId: ProviderId;
|
|
16
|
+
adapter: ProviderAdapter;
|
|
17
|
+
provider: Provider<DappRpcTypes>;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* DiscoveryClient manages provider adapters and exposes a unified
|
|
21
|
+
* Provider<DappRpcTypes> regardless of the underlying wallet type.
|
|
22
|
+
*
|
|
23
|
+
* It is UI-framework agnostic — the wallet picker UI is injected
|
|
24
|
+
* via the `walletPicker` config option.
|
|
25
|
+
*
|
|
26
|
+
* Client-level events (`discovery:connected`, `discovery:disconnected`,
|
|
27
|
+
* `discovery:error`) track the adapter session lifecycle. Provider-level
|
|
28
|
+
* CIP-103 events (statusChanged, accountsChanged, txChanged) live on
|
|
29
|
+
* the Provider — subscribe via `client.getProvider().on(...)`.
|
|
30
|
+
*/
|
|
31
|
+
export declare class DiscoveryClient {
|
|
32
|
+
private adapters;
|
|
33
|
+
private events;
|
|
34
|
+
private session;
|
|
35
|
+
private config;
|
|
36
|
+
private constructor();
|
|
37
|
+
/**
|
|
38
|
+
* Create and initialize a DiscoveryClient:
|
|
39
|
+
* register configured adapters and attempt session restore.
|
|
40
|
+
*/
|
|
41
|
+
static create(config: DiscoveryClientConfig): Promise<DiscoveryClient>;
|
|
42
|
+
private initialize;
|
|
43
|
+
private tryRestore;
|
|
44
|
+
registerAdapter(adapter: ProviderAdapter): void;
|
|
45
|
+
listAdapters(): ProviderAdapter[];
|
|
46
|
+
listWallets(): WalletInfo[];
|
|
47
|
+
/**
|
|
48
|
+
* Connect to a wallet.
|
|
49
|
+
* - If `providerId` is provided, connects directly to that wallet.
|
|
50
|
+
* - If omitted and a `walletPicker` was configured, opens the picker.
|
|
51
|
+
* - If omitted and no picker is configured, throws.
|
|
52
|
+
*/
|
|
53
|
+
connect(providerId?: ProviderId | undefined): Promise<void>;
|
|
54
|
+
disconnect(): Promise<void>;
|
|
55
|
+
getActiveSession(): ActiveSession | null;
|
|
56
|
+
getProvider(): Provider<DappRpcTypes>;
|
|
57
|
+
on<K extends DiscoveryClientEventName>(event: K, handler: DiscoveryClientEventHandler<K>): () => void;
|
|
58
|
+
removeListener<K extends DiscoveryClientEventName>(event: K, handler: DiscoveryClientEventHandler<K>): void;
|
|
59
|
+
destroy(): void;
|
|
60
|
+
}
|
|
61
|
+
//# sourceMappingURL=client.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAA;AACpE,OAAO,KAAK,EACR,UAAU,EACV,QAAQ,IAAI,YAAY,EAC3B,MAAM,6CAA6C,CAAA;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAC1E,OAAO,EAEH,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EACnC,MAAM,UAAU,CAAA;AAYjB,MAAM,WAAW,qBAAqB;IAClC,oCAAoC;IACpC,QAAQ,CAAC,EAAE,eAAe,EAAE,GAAG,SAAS,CAAA;IACxC;;;OAGG;IACH,YAAY,CAAC,EAAE,cAAc,GAAG,SAAS,CAAA;CAC5C;AAED,MAAM,WAAW,aAAa;IAC1B,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,eAAe,CAAA;IACxB,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAA;CACnC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,MAAM,CAAuB;IAErC,OAAO;IAIP;;;OAGG;WACU,MAAM,CACf,MAAM,EAAE,qBAAqB,GAC9B,OAAO,CAAC,eAAe,CAAC;YAMb,UAAU;YAUV,UAAU;IA4BxB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAI/C,YAAY,IAAI,eAAe,EAAE;IAIjC,WAAW,IAAI,UAAU,EAAE;IAM3B;;;;;OAKG;IACG,OAAO,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAuD3D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAcjC,gBAAgB,IAAI,aAAa,GAAG,IAAI;IAMxC,WAAW,IAAI,QAAQ,CAAC,YAAY,CAAC;IAOrC,EAAE,CAAC,CAAC,SAAS,wBAAwB,EACjC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACxC,MAAM,IAAI;IAIb,cAAc,CAAC,CAAC,SAAS,wBAAwB,EAC7C,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACxC,IAAI;IAIP,OAAO,IAAI,IAAI;CAIlB"}
|
package/dist/errors.d.ts
ADDED
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
export type DiscoveryErrorCode = 'WALLET_NOT_FOUND' | 'WALLET_NOT_INSTALLED' | 'USER_REJECTED' | 'SESSION_EXPIRED' | 'TRANSPORT_ERROR' | 'TIMEOUT' | 'PROVIDER_NOT_FOUND' | 'ALREADY_CONNECTED' | 'NOT_CONNECTED' | 'INTERNAL_ERROR';
|
|
2
|
+
export declare class DiscoveryError extends Error {
|
|
3
|
+
readonly code: DiscoveryErrorCode;
|
|
4
|
+
readonly cause?: unknown;
|
|
5
|
+
constructor(code: DiscoveryErrorCode, message: string, cause?: unknown);
|
|
6
|
+
}
|
|
7
|
+
export declare class WalletNotFoundError extends DiscoveryError {
|
|
8
|
+
constructor(providerId: string);
|
|
9
|
+
}
|
|
10
|
+
export declare class WalletNotInstalledError extends DiscoveryError {
|
|
11
|
+
constructor(providerId: string);
|
|
12
|
+
}
|
|
13
|
+
export declare class UserRejectedError extends DiscoveryError {
|
|
14
|
+
constructor(message?: string);
|
|
15
|
+
}
|
|
16
|
+
export declare class SessionExpiredError extends DiscoveryError {
|
|
17
|
+
constructor();
|
|
18
|
+
}
|
|
19
|
+
export declare class TimeoutError extends DiscoveryError {
|
|
20
|
+
constructor(operation: string, timeoutMs: number);
|
|
21
|
+
}
|
|
22
|
+
export declare class NotConnectedError extends DiscoveryError {
|
|
23
|
+
constructor();
|
|
24
|
+
}
|
|
25
|
+
//# sourceMappingURL=errors.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,kBAAkB,GACxB,kBAAkB,GAClB,sBAAsB,GACtB,eAAe,GACf,iBAAiB,GACjB,iBAAiB,GACjB,SAAS,GACT,oBAAoB,GACpB,mBAAmB,GACnB,eAAe,GACf,gBAAgB,CAAA;AAEtB,qBAAa,cAAe,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAA;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;gBAEZ,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAMzE;AAED,qBAAa,mBAAoB,SAAQ,cAAc;gBACvC,UAAU,EAAE,MAAM;CAGjC;AAED,qBAAa,uBAAwB,SAAQ,cAAc;gBAC3C,UAAU,EAAE,MAAM;CAMjC;AAED,qBAAa,iBAAkB,SAAQ,cAAc;gBACrC,OAAO,SAA8B;CAGpD;AAED,qBAAa,mBAAoB,SAAQ,cAAc;;CAItD;AAED,qBAAa,YAAa,SAAQ,cAAc;gBAChC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAGnD;AAED,qBAAa,iBAAkB,SAAQ,cAAc;;CAIpD"}
|
package/dist/events.d.ts
ADDED
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import type { ProviderId } from '@canton-network/core-wallet-dapp-rpc-client';
|
|
2
|
+
export interface DiscoveryConnectedEvent {
|
|
3
|
+
providerId: ProviderId;
|
|
4
|
+
}
|
|
5
|
+
export interface DiscoveryDisconnectedEvent {
|
|
6
|
+
providerId: ProviderId;
|
|
7
|
+
}
|
|
8
|
+
export interface DiscoveryErrorEvent {
|
|
9
|
+
code: string;
|
|
10
|
+
message: string;
|
|
11
|
+
cause?: unknown | undefined;
|
|
12
|
+
}
|
|
13
|
+
export type DiscoveryClientEventMap = {
|
|
14
|
+
'discovery:connected': DiscoveryConnectedEvent;
|
|
15
|
+
'discovery:disconnected': DiscoveryDisconnectedEvent;
|
|
16
|
+
'discovery:error': DiscoveryErrorEvent;
|
|
17
|
+
};
|
|
18
|
+
export type DiscoveryClientEventName = keyof DiscoveryClientEventMap;
|
|
19
|
+
export type DiscoveryClientEventHandler<K extends DiscoveryClientEventName> = (event: DiscoveryClientEventMap[K]) => void;
|
|
20
|
+
export declare class EventEmitter {
|
|
21
|
+
private listeners;
|
|
22
|
+
on<K extends DiscoveryClientEventName>(event: K, handler: DiscoveryClientEventHandler<K>): () => void;
|
|
23
|
+
removeListener<K extends DiscoveryClientEventName>(event: K, handler: DiscoveryClientEventHandler<K>): void;
|
|
24
|
+
emit<K extends DiscoveryClientEventName>(event: K, payload: DiscoveryClientEventMap[K]): void;
|
|
25
|
+
removeAllListeners(): void;
|
|
26
|
+
}
|
|
27
|
+
//# sourceMappingURL=events.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6CAA6C,CAAA;AAE7E,MAAM,WAAW,uBAAuB;IACpC,UAAU,EAAE,UAAU,CAAA;CACzB;AAED,MAAM,WAAW,0BAA0B;IACvC,UAAU,EAAE,UAAU,CAAA;CACzB;AAED,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAC9B;AAED,MAAM,MAAM,uBAAuB,GAAG;IAClC,qBAAqB,EAAE,uBAAuB,CAAA;IAC9C,wBAAwB,EAAE,0BAA0B,CAAA;IACpD,iBAAiB,EAAE,mBAAmB,CAAA;CACzC,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG,MAAM,uBAAuB,CAAA;AAEpE,MAAM,MAAM,2BAA2B,CAAC,CAAC,SAAS,wBAAwB,IAAI,CAC1E,KAAK,EAAE,uBAAuB,CAAC,CAAC,CAAC,KAChC,IAAI,CAAA;AAET,qBAAa,YAAY;IACrB,OAAO,CAAC,SAAS,CAAuD;IAExE,EAAE,CAAC,CAAC,SAAS,wBAAwB,EACjC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACxC,MAAM,IAAI;IASb,cAAc,CAAC,CAAC,SAAS,wBAAwB,EAC7C,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACxC,IAAI;IAMP,IAAI,CAAC,CAAC,SAAS,wBAAwB,EACnC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,GACpC,IAAI;IAMP,kBAAkB,IAAI,IAAI;CAG7B"}
|
package/dist/index.cjs
ADDED
|
@@ -0,0 +1,255 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
|
|
3
|
+
var __defProp = Object.defineProperty;
|
|
4
|
+
var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
|
|
5
|
+
var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
|
|
6
|
+
|
|
7
|
+
// src/errors.ts
|
|
8
|
+
var DiscoveryError = class extends Error {
|
|
9
|
+
constructor(code, message, cause) {
|
|
10
|
+
super(message);
|
|
11
|
+
__publicField(this, "code");
|
|
12
|
+
__publicField(this, "cause");
|
|
13
|
+
this.name = "DiscoveryError";
|
|
14
|
+
this.code = code;
|
|
15
|
+
this.cause = cause;
|
|
16
|
+
}
|
|
17
|
+
};
|
|
18
|
+
var WalletNotFoundError = class extends DiscoveryError {
|
|
19
|
+
constructor(providerId) {
|
|
20
|
+
super("WALLET_NOT_FOUND", `Provider "${providerId}" not found`);
|
|
21
|
+
}
|
|
22
|
+
};
|
|
23
|
+
var WalletNotInstalledError = class extends DiscoveryError {
|
|
24
|
+
constructor(providerId) {
|
|
25
|
+
super(
|
|
26
|
+
"WALLET_NOT_INSTALLED",
|
|
27
|
+
`Provider "${providerId}" is not installed or unavailable`
|
|
28
|
+
);
|
|
29
|
+
}
|
|
30
|
+
};
|
|
31
|
+
var UserRejectedError = class extends DiscoveryError {
|
|
32
|
+
constructor(message = "User rejected the request") {
|
|
33
|
+
super("USER_REJECTED", message);
|
|
34
|
+
}
|
|
35
|
+
};
|
|
36
|
+
var SessionExpiredError = class extends DiscoveryError {
|
|
37
|
+
constructor() {
|
|
38
|
+
super("SESSION_EXPIRED", "Session has expired, please reconnect");
|
|
39
|
+
}
|
|
40
|
+
};
|
|
41
|
+
var TimeoutError = class extends DiscoveryError {
|
|
42
|
+
constructor(operation, timeoutMs) {
|
|
43
|
+
super("TIMEOUT", `${operation} timed out after ${timeoutMs}ms`);
|
|
44
|
+
}
|
|
45
|
+
};
|
|
46
|
+
var NotConnectedError = class extends DiscoveryError {
|
|
47
|
+
constructor() {
|
|
48
|
+
super("NOT_CONNECTED", "No active wallet connection");
|
|
49
|
+
}
|
|
50
|
+
};
|
|
51
|
+
|
|
52
|
+
// src/events.ts
|
|
53
|
+
var EventEmitter = class {
|
|
54
|
+
constructor() {
|
|
55
|
+
__publicField(this, "listeners", /* @__PURE__ */ new Map());
|
|
56
|
+
}
|
|
57
|
+
on(event, handler) {
|
|
58
|
+
if (!this.listeners.has(event)) {
|
|
59
|
+
this.listeners.set(event, /* @__PURE__ */ new Set());
|
|
60
|
+
}
|
|
61
|
+
const set = this.listeners.get(event);
|
|
62
|
+
set.add(handler);
|
|
63
|
+
return () => set.delete(handler);
|
|
64
|
+
}
|
|
65
|
+
removeListener(event, handler) {
|
|
66
|
+
this.listeners.get(event)?.delete(handler);
|
|
67
|
+
}
|
|
68
|
+
emit(event, payload) {
|
|
69
|
+
this.listeners.get(event)?.forEach((handler) => handler(payload));
|
|
70
|
+
}
|
|
71
|
+
removeAllListeners() {
|
|
72
|
+
this.listeners.clear();
|
|
73
|
+
}
|
|
74
|
+
};
|
|
75
|
+
|
|
76
|
+
// src/storage.ts
|
|
77
|
+
var persistSession = (providerId) => {
|
|
78
|
+
try {
|
|
79
|
+
localStorage.setItem(
|
|
80
|
+
"splice_discovery_client_session" /* DISCOVERY_SESSION */,
|
|
81
|
+
JSON.stringify({ providerId })
|
|
82
|
+
);
|
|
83
|
+
} catch (e) {
|
|
84
|
+
console.error("Failed to persist discovery session:", e);
|
|
85
|
+
}
|
|
86
|
+
};
|
|
87
|
+
var loadPersistedSession = () => {
|
|
88
|
+
try {
|
|
89
|
+
const raw = localStorage.getItem("splice_discovery_client_session" /* DISCOVERY_SESSION */);
|
|
90
|
+
if (raw) return JSON.parse(raw);
|
|
91
|
+
} catch (e) {
|
|
92
|
+
console.error("Failed to parse stored discovery session:", e);
|
|
93
|
+
}
|
|
94
|
+
return null;
|
|
95
|
+
};
|
|
96
|
+
var clearPersistedSession = () => {
|
|
97
|
+
localStorage.removeItem("splice_discovery_client_session" /* DISCOVERY_SESSION */);
|
|
98
|
+
};
|
|
99
|
+
|
|
100
|
+
// src/client.ts
|
|
101
|
+
var DiscoveryClient = class _DiscoveryClient {
|
|
102
|
+
constructor(config) {
|
|
103
|
+
__publicField(this, "adapters", /* @__PURE__ */ new Map());
|
|
104
|
+
__publicField(this, "events", new EventEmitter());
|
|
105
|
+
__publicField(this, "session", null);
|
|
106
|
+
__publicField(this, "config");
|
|
107
|
+
this.config = config;
|
|
108
|
+
}
|
|
109
|
+
/**
|
|
110
|
+
* Create and initialize a DiscoveryClient:
|
|
111
|
+
* register configured adapters and attempt session restore.
|
|
112
|
+
*/
|
|
113
|
+
static async create(config) {
|
|
114
|
+
const client = new _DiscoveryClient(config);
|
|
115
|
+
await client.initialize();
|
|
116
|
+
return client;
|
|
117
|
+
}
|
|
118
|
+
async initialize() {
|
|
119
|
+
if (this.config.adapters) {
|
|
120
|
+
for (const adapter of this.config.adapters) {
|
|
121
|
+
this.adapters.set(adapter.providerId, adapter);
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
await this.tryRestore();
|
|
125
|
+
}
|
|
126
|
+
async tryRestore() {
|
|
127
|
+
const persisted = loadPersistedSession();
|
|
128
|
+
if (!persisted) return;
|
|
129
|
+
const adapter = this.adapters.get(persisted.providerId);
|
|
130
|
+
if (!adapter?.restore) return;
|
|
131
|
+
try {
|
|
132
|
+
const provider = await adapter.restore();
|
|
133
|
+
if (provider) {
|
|
134
|
+
this.session = {
|
|
135
|
+
providerId: adapter.providerId,
|
|
136
|
+
adapter,
|
|
137
|
+
provider
|
|
138
|
+
};
|
|
139
|
+
this.events.emit("discovery:connected", {
|
|
140
|
+
providerId: adapter.providerId
|
|
141
|
+
});
|
|
142
|
+
} else {
|
|
143
|
+
clearPersistedSession();
|
|
144
|
+
}
|
|
145
|
+
} catch {
|
|
146
|
+
clearPersistedSession();
|
|
147
|
+
}
|
|
148
|
+
}
|
|
149
|
+
// ── Adapter management ─────────────────────────────────
|
|
150
|
+
registerAdapter(adapter) {
|
|
151
|
+
this.adapters.set(adapter.providerId, adapter);
|
|
152
|
+
}
|
|
153
|
+
listAdapters() {
|
|
154
|
+
return Array.from(this.adapters.values());
|
|
155
|
+
}
|
|
156
|
+
listWallets() {
|
|
157
|
+
return this.listAdapters().map((a) => a.getInfo());
|
|
158
|
+
}
|
|
159
|
+
// ── Connection lifecycle ───────────────────────────────
|
|
160
|
+
/**
|
|
161
|
+
* Connect to a wallet.
|
|
162
|
+
* - If `providerId` is provided, connects directly to that wallet.
|
|
163
|
+
* - If omitted and a `walletPicker` was configured, opens the picker.
|
|
164
|
+
* - If omitted and no picker is configured, throws.
|
|
165
|
+
*/
|
|
166
|
+
async connect(providerId) {
|
|
167
|
+
let targetId = providerId;
|
|
168
|
+
if (!targetId) {
|
|
169
|
+
if (!this.config.walletPicker) {
|
|
170
|
+
throw new DiscoveryError(
|
|
171
|
+
"INTERNAL_ERROR",
|
|
172
|
+
"No providerId provided and no walletPicker configured"
|
|
173
|
+
);
|
|
174
|
+
}
|
|
175
|
+
const entries = this.listAdapters().map((a) => {
|
|
176
|
+
const info = a.getInfo();
|
|
177
|
+
return {
|
|
178
|
+
providerId: info.providerId,
|
|
179
|
+
name: info.name,
|
|
180
|
+
type: info.type,
|
|
181
|
+
description: info.description,
|
|
182
|
+
icon: info.icon,
|
|
183
|
+
url: info.url
|
|
184
|
+
};
|
|
185
|
+
});
|
|
186
|
+
const picked = await this.config.walletPicker(entries);
|
|
187
|
+
targetId = picked.providerId;
|
|
188
|
+
}
|
|
189
|
+
if (!targetId) {
|
|
190
|
+
throw new DiscoveryError(
|
|
191
|
+
"INTERNAL_ERROR",
|
|
192
|
+
"No providerId selected from wallet picker"
|
|
193
|
+
);
|
|
194
|
+
}
|
|
195
|
+
const adapter = this.adapters.get(targetId);
|
|
196
|
+
if (!adapter) throw new WalletNotFoundError(targetId);
|
|
197
|
+
try {
|
|
198
|
+
const provider = adapter.provider();
|
|
199
|
+
await provider.request({ method: "connect" });
|
|
200
|
+
this.session = { providerId: targetId, adapter, provider };
|
|
201
|
+
persistSession(targetId);
|
|
202
|
+
this.events.emit("discovery:connected", { providerId: targetId });
|
|
203
|
+
} catch (err) {
|
|
204
|
+
this.events.emit("discovery:error", {
|
|
205
|
+
code: err instanceof DiscoveryError ? err.code : "INTERNAL_ERROR",
|
|
206
|
+
message: err instanceof Error ? err.message : "Connection failed",
|
|
207
|
+
cause: err
|
|
208
|
+
});
|
|
209
|
+
throw err;
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
async disconnect() {
|
|
213
|
+
if (!this.session) return;
|
|
214
|
+
const { providerId, adapter, provider } = this.session;
|
|
215
|
+
try {
|
|
216
|
+
await provider.request({ method: "disconnect" });
|
|
217
|
+
} finally {
|
|
218
|
+
adapter.teardown();
|
|
219
|
+
this.session = null;
|
|
220
|
+
clearPersistedSession();
|
|
221
|
+
this.events.emit("discovery:disconnected", { providerId });
|
|
222
|
+
}
|
|
223
|
+
}
|
|
224
|
+
getActiveSession() {
|
|
225
|
+
return this.session;
|
|
226
|
+
}
|
|
227
|
+
// ── Provider access ────────────────────────────────────
|
|
228
|
+
getProvider() {
|
|
229
|
+
if (!this.session) throw new NotConnectedError();
|
|
230
|
+
return this.session.provider;
|
|
231
|
+
}
|
|
232
|
+
// ── Events ─────────────────────────────────────────────
|
|
233
|
+
on(event, handler) {
|
|
234
|
+
return this.events.on(event, handler);
|
|
235
|
+
}
|
|
236
|
+
removeListener(event, handler) {
|
|
237
|
+
this.events.removeListener(event, handler);
|
|
238
|
+
}
|
|
239
|
+
destroy() {
|
|
240
|
+
this.events.removeAllListeners();
|
|
241
|
+
this.session = null;
|
|
242
|
+
}
|
|
243
|
+
};
|
|
244
|
+
|
|
245
|
+
exports.DiscoveryClient = DiscoveryClient;
|
|
246
|
+
exports.DiscoveryError = DiscoveryError;
|
|
247
|
+
exports.EventEmitter = EventEmitter;
|
|
248
|
+
exports.NotConnectedError = NotConnectedError;
|
|
249
|
+
exports.SessionExpiredError = SessionExpiredError;
|
|
250
|
+
exports.TimeoutError = TimeoutError;
|
|
251
|
+
exports.UserRejectedError = UserRejectedError;
|
|
252
|
+
exports.WalletNotFoundError = WalletNotFoundError;
|
|
253
|
+
exports.WalletNotInstalledError = WalletNotInstalledError;
|
|
254
|
+
//# sourceMappingURL=index.cjs.map
|
|
255
|
+
//# sourceMappingURL=index.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/errors.ts","../src/events.ts","../src/storage.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["// Copyright (c) 2025-2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nexport type DiscoveryErrorCode =\n | 'WALLET_NOT_FOUND'\n | 'WALLET_NOT_INSTALLED'\n | 'USER_REJECTED'\n | 'SESSION_EXPIRED'\n | 'TRANSPORT_ERROR'\n | 'TIMEOUT'\n | 'PROVIDER_NOT_FOUND'\n | 'ALREADY_CONNECTED'\n | 'NOT_CONNECTED'\n | 'INTERNAL_ERROR'\n\nexport class DiscoveryError extends Error {\n readonly code: DiscoveryErrorCode\n readonly cause?: unknown\n\n constructor(code: DiscoveryErrorCode, message: string, cause?: unknown) {\n super(message)\n this.name = 'DiscoveryError'\n this.code = code\n this.cause = cause\n }\n}\n\nexport class WalletNotFoundError extends DiscoveryError {\n constructor(providerId: string) {\n super('WALLET_NOT_FOUND', `Provider \"${providerId}\" not found`)\n }\n}\n\nexport class WalletNotInstalledError extends DiscoveryError {\n constructor(providerId: string) {\n super(\n 'WALLET_NOT_INSTALLED',\n `Provider \"${providerId}\" is not installed or unavailable`\n )\n }\n}\n\nexport class UserRejectedError extends DiscoveryError {\n constructor(message = 'User rejected the request') {\n super('USER_REJECTED', message)\n }\n}\n\nexport class SessionExpiredError extends DiscoveryError {\n constructor() {\n super('SESSION_EXPIRED', 'Session has expired, please reconnect')\n }\n}\n\nexport class TimeoutError extends DiscoveryError {\n constructor(operation: string, timeoutMs: number) {\n super('TIMEOUT', `${operation} timed out after ${timeoutMs}ms`)\n }\n}\n\nexport class NotConnectedError extends DiscoveryError {\n constructor() {\n super('NOT_CONNECTED', 'No active wallet connection')\n }\n}\n","// Copyright (c) 2025-2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { ProviderId } from '@canton-network/core-wallet-dapp-rpc-client'\n\nexport interface DiscoveryConnectedEvent {\n providerId: ProviderId\n}\n\nexport interface DiscoveryDisconnectedEvent {\n providerId: ProviderId\n}\n\nexport interface DiscoveryErrorEvent {\n code: string\n message: string\n cause?: unknown | undefined\n}\n\nexport type DiscoveryClientEventMap = {\n 'discovery:connected': DiscoveryConnectedEvent\n 'discovery:disconnected': DiscoveryDisconnectedEvent\n 'discovery:error': DiscoveryErrorEvent\n}\n\nexport type DiscoveryClientEventName = keyof DiscoveryClientEventMap\n\nexport type DiscoveryClientEventHandler<K extends DiscoveryClientEventName> = (\n event: DiscoveryClientEventMap[K]\n) => void\n\nexport class EventEmitter {\n private listeners = new Map<string, Set<(...args: unknown[]) => void>>()\n\n on<K extends DiscoveryClientEventName>(\n event: K,\n handler: DiscoveryClientEventHandler<K>\n ): () => void {\n if (!this.listeners.has(event)) {\n this.listeners.set(event, new Set())\n }\n const set = this.listeners.get(event)!\n set.add(handler as (...args: unknown[]) => void)\n return () => set.delete(handler as (...args: unknown[]) => void)\n }\n\n removeListener<K extends DiscoveryClientEventName>(\n event: K,\n handler: DiscoveryClientEventHandler<K>\n ): void {\n this.listeners\n .get(event)\n ?.delete(handler as (...args: unknown[]) => void)\n }\n\n emit<K extends DiscoveryClientEventName>(\n event: K,\n payload: DiscoveryClientEventMap[K]\n ): void {\n this.listeners\n .get(event)\n ?.forEach((handler) => handler(payload as never))\n }\n\n removeAllListeners(): void {\n this.listeners.clear()\n }\n}\n","// Copyright (c) 2025-2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { ProviderId } from '@canton-network/core-wallet-dapp-rpc-client'\n\nenum LOCAL_STORAGE {\n DISCOVERY_SESSION = 'splice_discovery_client_session',\n}\n\nexport const persistSession = (providerId: ProviderId): void => {\n try {\n localStorage.setItem(\n LOCAL_STORAGE.DISCOVERY_SESSION,\n JSON.stringify({ providerId })\n )\n } catch (e) {\n console.error('Failed to persist discovery session:', e)\n }\n}\n\nexport const loadPersistedSession = (): { providerId: ProviderId } | null => {\n try {\n const raw = localStorage.getItem(LOCAL_STORAGE.DISCOVERY_SESSION)\n if (raw) return JSON.parse(raw)\n } catch (e) {\n console.error('Failed to parse stored discovery session:', e)\n }\n return null\n}\n\nexport const clearPersistedSession = (): void => {\n localStorage.removeItem(LOCAL_STORAGE.DISCOVERY_SESSION)\n}\n","// Copyright (c) 2025-2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { Provider } from '@canton-network/core-splice-provider'\nimport type {\n ProviderId,\n RpcTypes as DappRpcTypes,\n} from '@canton-network/core-wallet-dapp-rpc-client'\nimport type { ProviderAdapter, WalletInfo, WalletPickerFn } from './types'\nimport {\n EventEmitter,\n type DiscoveryClientEventName,\n type DiscoveryClientEventHandler,\n} from './events'\nimport {\n WalletNotFoundError,\n NotConnectedError,\n DiscoveryError,\n} from './errors'\nimport {\n loadPersistedSession,\n persistSession,\n clearPersistedSession,\n} from './storage'\n\nexport interface DiscoveryClientConfig {\n /** Adapters to register on init. */\n adapters?: ProviderAdapter[] | undefined\n /**\n * A function that presents wallet choices to the user and returns their selection.\n * When not provided, `connect()` requires a `providerId` argument.\n */\n walletPicker?: WalletPickerFn | undefined\n}\n\nexport interface ActiveSession {\n providerId: ProviderId\n adapter: ProviderAdapter\n provider: Provider<DappRpcTypes>\n}\n\n/**\n * DiscoveryClient manages provider adapters and exposes a unified\n * Provider<DappRpcTypes> regardless of the underlying wallet type.\n *\n * It is UI-framework agnostic — the wallet picker UI is injected\n * via the `walletPicker` config option.\n *\n * Client-level events (`discovery:connected`, `discovery:disconnected`,\n * `discovery:error`) track the adapter session lifecycle. Provider-level\n * CIP-103 events (statusChanged, accountsChanged, txChanged) live on\n * the Provider — subscribe via `client.getProvider().on(...)`.\n */\nexport class DiscoveryClient {\n private adapters = new Map<ProviderId, ProviderAdapter>()\n private events = new EventEmitter()\n private session: ActiveSession | null = null\n private config: DiscoveryClientConfig\n\n private constructor(config: DiscoveryClientConfig) {\n this.config = config\n }\n\n /**\n * Create and initialize a DiscoveryClient:\n * register configured adapters and attempt session restore.\n */\n static async create(\n config: DiscoveryClientConfig\n ): Promise<DiscoveryClient> {\n const client = new DiscoveryClient(config)\n await client.initialize()\n return client\n }\n\n private async initialize(): Promise<void> {\n if (this.config.adapters) {\n for (const adapter of this.config.adapters) {\n this.adapters.set(adapter.providerId, adapter)\n }\n }\n\n await this.tryRestore()\n }\n\n private async tryRestore(): Promise<void> {\n const persisted = loadPersistedSession()\n if (!persisted) return\n\n const adapter = this.adapters.get(persisted.providerId)\n if (!adapter?.restore) return\n\n try {\n const provider = await adapter.restore()\n if (provider) {\n this.session = {\n providerId: adapter.providerId,\n adapter,\n provider,\n }\n this.events.emit('discovery:connected', {\n providerId: adapter.providerId,\n })\n } else {\n clearPersistedSession()\n }\n } catch {\n clearPersistedSession()\n }\n }\n\n // ── Adapter management ─────────────────────────────────\n\n registerAdapter(adapter: ProviderAdapter): void {\n this.adapters.set(adapter.providerId, adapter)\n }\n\n listAdapters(): ProviderAdapter[] {\n return Array.from(this.adapters.values())\n }\n\n listWallets(): WalletInfo[] {\n return this.listAdapters().map((a) => a.getInfo())\n }\n\n // ── Connection lifecycle ───────────────────────────────\n\n /**\n * Connect to a wallet.\n * - If `providerId` is provided, connects directly to that wallet.\n * - If omitted and a `walletPicker` was configured, opens the picker.\n * - If omitted and no picker is configured, throws.\n */\n async connect(providerId?: ProviderId | undefined): Promise<void> {\n let targetId = providerId\n\n if (!targetId) {\n if (!this.config.walletPicker) {\n throw new DiscoveryError(\n 'INTERNAL_ERROR',\n 'No providerId provided and no walletPicker configured'\n )\n }\n\n const entries = this.listAdapters().map((a) => {\n const info = a.getInfo()\n return {\n providerId: info.providerId as string,\n name: info.name,\n type: info.type,\n description: info.description,\n icon: info.icon,\n url: info.url,\n }\n })\n\n const picked = await this.config.walletPicker(entries)\n targetId = picked.providerId\n }\n\n if (!targetId) {\n throw new DiscoveryError(\n 'INTERNAL_ERROR',\n 'No providerId selected from wallet picker'\n )\n }\n\n const adapter = this.adapters.get(targetId)\n if (!adapter) throw new WalletNotFoundError(targetId)\n\n try {\n const provider = adapter.provider()\n await provider.request({ method: 'connect' })\n this.session = { providerId: targetId, adapter, provider }\n persistSession(targetId)\n this.events.emit('discovery:connected', { providerId: targetId })\n } catch (err) {\n this.events.emit('discovery:error', {\n code:\n err instanceof DiscoveryError ? err.code : 'INTERNAL_ERROR',\n message:\n err instanceof Error ? err.message : 'Connection failed',\n cause: err,\n })\n throw err\n }\n }\n\n async disconnect(): Promise<void> {\n if (!this.session) return\n\n const { providerId, adapter, provider } = this.session\n try {\n await provider.request({ method: 'disconnect' })\n } finally {\n adapter.teardown()\n this.session = null\n clearPersistedSession()\n this.events.emit('discovery:disconnected', { providerId })\n }\n }\n\n getActiveSession(): ActiveSession | null {\n return this.session\n }\n\n // ── Provider access ────────────────────────────────────\n\n getProvider(): Provider<DappRpcTypes> {\n if (!this.session) throw new NotConnectedError()\n return this.session.provider\n }\n\n // ── Events ─────────────────────────────────────────────\n\n on<K extends DiscoveryClientEventName>(\n event: K,\n handler: DiscoveryClientEventHandler<K>\n ): () => void {\n return this.events.on(event, handler)\n }\n\n removeListener<K extends DiscoveryClientEventName>(\n event: K,\n handler: DiscoveryClientEventHandler<K>\n ): void {\n this.events.removeListener(event, handler)\n }\n\n destroy(): void {\n this.events.removeAllListeners()\n this.session = null\n }\n}\n"]}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC1C,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,245 @@
|
|
|
1
|
+
var __defProp = Object.defineProperty;
|
|
2
|
+
var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
|
|
3
|
+
var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
|
|
4
|
+
|
|
5
|
+
// src/errors.ts
|
|
6
|
+
var DiscoveryError = class extends Error {
|
|
7
|
+
constructor(code, message, cause) {
|
|
8
|
+
super(message);
|
|
9
|
+
__publicField(this, "code");
|
|
10
|
+
__publicField(this, "cause");
|
|
11
|
+
this.name = "DiscoveryError";
|
|
12
|
+
this.code = code;
|
|
13
|
+
this.cause = cause;
|
|
14
|
+
}
|
|
15
|
+
};
|
|
16
|
+
var WalletNotFoundError = class extends DiscoveryError {
|
|
17
|
+
constructor(providerId) {
|
|
18
|
+
super("WALLET_NOT_FOUND", `Provider "${providerId}" not found`);
|
|
19
|
+
}
|
|
20
|
+
};
|
|
21
|
+
var WalletNotInstalledError = class extends DiscoveryError {
|
|
22
|
+
constructor(providerId) {
|
|
23
|
+
super(
|
|
24
|
+
"WALLET_NOT_INSTALLED",
|
|
25
|
+
`Provider "${providerId}" is not installed or unavailable`
|
|
26
|
+
);
|
|
27
|
+
}
|
|
28
|
+
};
|
|
29
|
+
var UserRejectedError = class extends DiscoveryError {
|
|
30
|
+
constructor(message = "User rejected the request") {
|
|
31
|
+
super("USER_REJECTED", message);
|
|
32
|
+
}
|
|
33
|
+
};
|
|
34
|
+
var SessionExpiredError = class extends DiscoveryError {
|
|
35
|
+
constructor() {
|
|
36
|
+
super("SESSION_EXPIRED", "Session has expired, please reconnect");
|
|
37
|
+
}
|
|
38
|
+
};
|
|
39
|
+
var TimeoutError = class extends DiscoveryError {
|
|
40
|
+
constructor(operation, timeoutMs) {
|
|
41
|
+
super("TIMEOUT", `${operation} timed out after ${timeoutMs}ms`);
|
|
42
|
+
}
|
|
43
|
+
};
|
|
44
|
+
var NotConnectedError = class extends DiscoveryError {
|
|
45
|
+
constructor() {
|
|
46
|
+
super("NOT_CONNECTED", "No active wallet connection");
|
|
47
|
+
}
|
|
48
|
+
};
|
|
49
|
+
|
|
50
|
+
// src/events.ts
|
|
51
|
+
var EventEmitter = class {
|
|
52
|
+
constructor() {
|
|
53
|
+
__publicField(this, "listeners", /* @__PURE__ */ new Map());
|
|
54
|
+
}
|
|
55
|
+
on(event, handler) {
|
|
56
|
+
if (!this.listeners.has(event)) {
|
|
57
|
+
this.listeners.set(event, /* @__PURE__ */ new Set());
|
|
58
|
+
}
|
|
59
|
+
const set = this.listeners.get(event);
|
|
60
|
+
set.add(handler);
|
|
61
|
+
return () => set.delete(handler);
|
|
62
|
+
}
|
|
63
|
+
removeListener(event, handler) {
|
|
64
|
+
this.listeners.get(event)?.delete(handler);
|
|
65
|
+
}
|
|
66
|
+
emit(event, payload) {
|
|
67
|
+
this.listeners.get(event)?.forEach((handler) => handler(payload));
|
|
68
|
+
}
|
|
69
|
+
removeAllListeners() {
|
|
70
|
+
this.listeners.clear();
|
|
71
|
+
}
|
|
72
|
+
};
|
|
73
|
+
|
|
74
|
+
// src/storage.ts
|
|
75
|
+
var persistSession = (providerId) => {
|
|
76
|
+
try {
|
|
77
|
+
localStorage.setItem(
|
|
78
|
+
"splice_discovery_client_session" /* DISCOVERY_SESSION */,
|
|
79
|
+
JSON.stringify({ providerId })
|
|
80
|
+
);
|
|
81
|
+
} catch (e) {
|
|
82
|
+
console.error("Failed to persist discovery session:", e);
|
|
83
|
+
}
|
|
84
|
+
};
|
|
85
|
+
var loadPersistedSession = () => {
|
|
86
|
+
try {
|
|
87
|
+
const raw = localStorage.getItem("splice_discovery_client_session" /* DISCOVERY_SESSION */);
|
|
88
|
+
if (raw) return JSON.parse(raw);
|
|
89
|
+
} catch (e) {
|
|
90
|
+
console.error("Failed to parse stored discovery session:", e);
|
|
91
|
+
}
|
|
92
|
+
return null;
|
|
93
|
+
};
|
|
94
|
+
var clearPersistedSession = () => {
|
|
95
|
+
localStorage.removeItem("splice_discovery_client_session" /* DISCOVERY_SESSION */);
|
|
96
|
+
};
|
|
97
|
+
|
|
98
|
+
// src/client.ts
|
|
99
|
+
var DiscoveryClient = class _DiscoveryClient {
|
|
100
|
+
constructor(config) {
|
|
101
|
+
__publicField(this, "adapters", /* @__PURE__ */ new Map());
|
|
102
|
+
__publicField(this, "events", new EventEmitter());
|
|
103
|
+
__publicField(this, "session", null);
|
|
104
|
+
__publicField(this, "config");
|
|
105
|
+
this.config = config;
|
|
106
|
+
}
|
|
107
|
+
/**
|
|
108
|
+
* Create and initialize a DiscoveryClient:
|
|
109
|
+
* register configured adapters and attempt session restore.
|
|
110
|
+
*/
|
|
111
|
+
static async create(config) {
|
|
112
|
+
const client = new _DiscoveryClient(config);
|
|
113
|
+
await client.initialize();
|
|
114
|
+
return client;
|
|
115
|
+
}
|
|
116
|
+
async initialize() {
|
|
117
|
+
if (this.config.adapters) {
|
|
118
|
+
for (const adapter of this.config.adapters) {
|
|
119
|
+
this.adapters.set(adapter.providerId, adapter);
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
await this.tryRestore();
|
|
123
|
+
}
|
|
124
|
+
async tryRestore() {
|
|
125
|
+
const persisted = loadPersistedSession();
|
|
126
|
+
if (!persisted) return;
|
|
127
|
+
const adapter = this.adapters.get(persisted.providerId);
|
|
128
|
+
if (!adapter?.restore) return;
|
|
129
|
+
try {
|
|
130
|
+
const provider = await adapter.restore();
|
|
131
|
+
if (provider) {
|
|
132
|
+
this.session = {
|
|
133
|
+
providerId: adapter.providerId,
|
|
134
|
+
adapter,
|
|
135
|
+
provider
|
|
136
|
+
};
|
|
137
|
+
this.events.emit("discovery:connected", {
|
|
138
|
+
providerId: adapter.providerId
|
|
139
|
+
});
|
|
140
|
+
} else {
|
|
141
|
+
clearPersistedSession();
|
|
142
|
+
}
|
|
143
|
+
} catch {
|
|
144
|
+
clearPersistedSession();
|
|
145
|
+
}
|
|
146
|
+
}
|
|
147
|
+
// ── Adapter management ─────────────────────────────────
|
|
148
|
+
registerAdapter(adapter) {
|
|
149
|
+
this.adapters.set(adapter.providerId, adapter);
|
|
150
|
+
}
|
|
151
|
+
listAdapters() {
|
|
152
|
+
return Array.from(this.adapters.values());
|
|
153
|
+
}
|
|
154
|
+
listWallets() {
|
|
155
|
+
return this.listAdapters().map((a) => a.getInfo());
|
|
156
|
+
}
|
|
157
|
+
// ── Connection lifecycle ───────────────────────────────
|
|
158
|
+
/**
|
|
159
|
+
* Connect to a wallet.
|
|
160
|
+
* - If `providerId` is provided, connects directly to that wallet.
|
|
161
|
+
* - If omitted and a `walletPicker` was configured, opens the picker.
|
|
162
|
+
* - If omitted and no picker is configured, throws.
|
|
163
|
+
*/
|
|
164
|
+
async connect(providerId) {
|
|
165
|
+
let targetId = providerId;
|
|
166
|
+
if (!targetId) {
|
|
167
|
+
if (!this.config.walletPicker) {
|
|
168
|
+
throw new DiscoveryError(
|
|
169
|
+
"INTERNAL_ERROR",
|
|
170
|
+
"No providerId provided and no walletPicker configured"
|
|
171
|
+
);
|
|
172
|
+
}
|
|
173
|
+
const entries = this.listAdapters().map((a) => {
|
|
174
|
+
const info = a.getInfo();
|
|
175
|
+
return {
|
|
176
|
+
providerId: info.providerId,
|
|
177
|
+
name: info.name,
|
|
178
|
+
type: info.type,
|
|
179
|
+
description: info.description,
|
|
180
|
+
icon: info.icon,
|
|
181
|
+
url: info.url
|
|
182
|
+
};
|
|
183
|
+
});
|
|
184
|
+
const picked = await this.config.walletPicker(entries);
|
|
185
|
+
targetId = picked.providerId;
|
|
186
|
+
}
|
|
187
|
+
if (!targetId) {
|
|
188
|
+
throw new DiscoveryError(
|
|
189
|
+
"INTERNAL_ERROR",
|
|
190
|
+
"No providerId selected from wallet picker"
|
|
191
|
+
);
|
|
192
|
+
}
|
|
193
|
+
const adapter = this.adapters.get(targetId);
|
|
194
|
+
if (!adapter) throw new WalletNotFoundError(targetId);
|
|
195
|
+
try {
|
|
196
|
+
const provider = adapter.provider();
|
|
197
|
+
await provider.request({ method: "connect" });
|
|
198
|
+
this.session = { providerId: targetId, adapter, provider };
|
|
199
|
+
persistSession(targetId);
|
|
200
|
+
this.events.emit("discovery:connected", { providerId: targetId });
|
|
201
|
+
} catch (err) {
|
|
202
|
+
this.events.emit("discovery:error", {
|
|
203
|
+
code: err instanceof DiscoveryError ? err.code : "INTERNAL_ERROR",
|
|
204
|
+
message: err instanceof Error ? err.message : "Connection failed",
|
|
205
|
+
cause: err
|
|
206
|
+
});
|
|
207
|
+
throw err;
|
|
208
|
+
}
|
|
209
|
+
}
|
|
210
|
+
async disconnect() {
|
|
211
|
+
if (!this.session) return;
|
|
212
|
+
const { providerId, adapter, provider } = this.session;
|
|
213
|
+
try {
|
|
214
|
+
await provider.request({ method: "disconnect" });
|
|
215
|
+
} finally {
|
|
216
|
+
adapter.teardown();
|
|
217
|
+
this.session = null;
|
|
218
|
+
clearPersistedSession();
|
|
219
|
+
this.events.emit("discovery:disconnected", { providerId });
|
|
220
|
+
}
|
|
221
|
+
}
|
|
222
|
+
getActiveSession() {
|
|
223
|
+
return this.session;
|
|
224
|
+
}
|
|
225
|
+
// ── Provider access ────────────────────────────────────
|
|
226
|
+
getProvider() {
|
|
227
|
+
if (!this.session) throw new NotConnectedError();
|
|
228
|
+
return this.session.provider;
|
|
229
|
+
}
|
|
230
|
+
// ── Events ─────────────────────────────────────────────
|
|
231
|
+
on(event, handler) {
|
|
232
|
+
return this.events.on(event, handler);
|
|
233
|
+
}
|
|
234
|
+
removeListener(event, handler) {
|
|
235
|
+
this.events.removeListener(event, handler);
|
|
236
|
+
}
|
|
237
|
+
destroy() {
|
|
238
|
+
this.events.removeAllListeners();
|
|
239
|
+
this.session = null;
|
|
240
|
+
}
|
|
241
|
+
};
|
|
242
|
+
|
|
243
|
+
export { DiscoveryClient, DiscoveryError, EventEmitter, NotConnectedError, SessionExpiredError, TimeoutError, UserRejectedError, WalletNotFoundError, WalletNotInstalledError };
|
|
244
|
+
//# sourceMappingURL=index.js.map
|
|
245
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/errors.ts","../src/events.ts","../src/storage.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// Copyright (c) 2025-2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nexport type DiscoveryErrorCode =\n | 'WALLET_NOT_FOUND'\n | 'WALLET_NOT_INSTALLED'\n | 'USER_REJECTED'\n | 'SESSION_EXPIRED'\n | 'TRANSPORT_ERROR'\n | 'TIMEOUT'\n | 'PROVIDER_NOT_FOUND'\n | 'ALREADY_CONNECTED'\n | 'NOT_CONNECTED'\n | 'INTERNAL_ERROR'\n\nexport class DiscoveryError extends Error {\n readonly code: DiscoveryErrorCode\n readonly cause?: unknown\n\n constructor(code: DiscoveryErrorCode, message: string, cause?: unknown) {\n super(message)\n this.name = 'DiscoveryError'\n this.code = code\n this.cause = cause\n }\n}\n\nexport class WalletNotFoundError extends DiscoveryError {\n constructor(providerId: string) {\n super('WALLET_NOT_FOUND', `Provider \"${providerId}\" not found`)\n }\n}\n\nexport class WalletNotInstalledError extends DiscoveryError {\n constructor(providerId: string) {\n super(\n 'WALLET_NOT_INSTALLED',\n `Provider \"${providerId}\" is not installed or unavailable`\n )\n }\n}\n\nexport class UserRejectedError extends DiscoveryError {\n constructor(message = 'User rejected the request') {\n super('USER_REJECTED', message)\n }\n}\n\nexport class SessionExpiredError extends DiscoveryError {\n constructor() {\n super('SESSION_EXPIRED', 'Session has expired, please reconnect')\n }\n}\n\nexport class TimeoutError extends DiscoveryError {\n constructor(operation: string, timeoutMs: number) {\n super('TIMEOUT', `${operation} timed out after ${timeoutMs}ms`)\n }\n}\n\nexport class NotConnectedError extends DiscoveryError {\n constructor() {\n super('NOT_CONNECTED', 'No active wallet connection')\n }\n}\n","// Copyright (c) 2025-2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { ProviderId } from '@canton-network/core-wallet-dapp-rpc-client'\n\nexport interface DiscoveryConnectedEvent {\n providerId: ProviderId\n}\n\nexport interface DiscoveryDisconnectedEvent {\n providerId: ProviderId\n}\n\nexport interface DiscoveryErrorEvent {\n code: string\n message: string\n cause?: unknown | undefined\n}\n\nexport type DiscoveryClientEventMap = {\n 'discovery:connected': DiscoveryConnectedEvent\n 'discovery:disconnected': DiscoveryDisconnectedEvent\n 'discovery:error': DiscoveryErrorEvent\n}\n\nexport type DiscoveryClientEventName = keyof DiscoveryClientEventMap\n\nexport type DiscoveryClientEventHandler<K extends DiscoveryClientEventName> = (\n event: DiscoveryClientEventMap[K]\n) => void\n\nexport class EventEmitter {\n private listeners = new Map<string, Set<(...args: unknown[]) => void>>()\n\n on<K extends DiscoveryClientEventName>(\n event: K,\n handler: DiscoveryClientEventHandler<K>\n ): () => void {\n if (!this.listeners.has(event)) {\n this.listeners.set(event, new Set())\n }\n const set = this.listeners.get(event)!\n set.add(handler as (...args: unknown[]) => void)\n return () => set.delete(handler as (...args: unknown[]) => void)\n }\n\n removeListener<K extends DiscoveryClientEventName>(\n event: K,\n handler: DiscoveryClientEventHandler<K>\n ): void {\n this.listeners\n .get(event)\n ?.delete(handler as (...args: unknown[]) => void)\n }\n\n emit<K extends DiscoveryClientEventName>(\n event: K,\n payload: DiscoveryClientEventMap[K]\n ): void {\n this.listeners\n .get(event)\n ?.forEach((handler) => handler(payload as never))\n }\n\n removeAllListeners(): void {\n this.listeners.clear()\n }\n}\n","// Copyright (c) 2025-2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport { ProviderId } from '@canton-network/core-wallet-dapp-rpc-client'\n\nenum LOCAL_STORAGE {\n DISCOVERY_SESSION = 'splice_discovery_client_session',\n}\n\nexport const persistSession = (providerId: ProviderId): void => {\n try {\n localStorage.setItem(\n LOCAL_STORAGE.DISCOVERY_SESSION,\n JSON.stringify({ providerId })\n )\n } catch (e) {\n console.error('Failed to persist discovery session:', e)\n }\n}\n\nexport const loadPersistedSession = (): { providerId: ProviderId } | null => {\n try {\n const raw = localStorage.getItem(LOCAL_STORAGE.DISCOVERY_SESSION)\n if (raw) return JSON.parse(raw)\n } catch (e) {\n console.error('Failed to parse stored discovery session:', e)\n }\n return null\n}\n\nexport const clearPersistedSession = (): void => {\n localStorage.removeItem(LOCAL_STORAGE.DISCOVERY_SESSION)\n}\n","// Copyright (c) 2025-2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.\n// SPDX-License-Identifier: Apache-2.0\n\nimport type { Provider } from '@canton-network/core-splice-provider'\nimport type {\n ProviderId,\n RpcTypes as DappRpcTypes,\n} from '@canton-network/core-wallet-dapp-rpc-client'\nimport type { ProviderAdapter, WalletInfo, WalletPickerFn } from './types'\nimport {\n EventEmitter,\n type DiscoveryClientEventName,\n type DiscoveryClientEventHandler,\n} from './events'\nimport {\n WalletNotFoundError,\n NotConnectedError,\n DiscoveryError,\n} from './errors'\nimport {\n loadPersistedSession,\n persistSession,\n clearPersistedSession,\n} from './storage'\n\nexport interface DiscoveryClientConfig {\n /** Adapters to register on init. */\n adapters?: ProviderAdapter[] | undefined\n /**\n * A function that presents wallet choices to the user and returns their selection.\n * When not provided, `connect()` requires a `providerId` argument.\n */\n walletPicker?: WalletPickerFn | undefined\n}\n\nexport interface ActiveSession {\n providerId: ProviderId\n adapter: ProviderAdapter\n provider: Provider<DappRpcTypes>\n}\n\n/**\n * DiscoveryClient manages provider adapters and exposes a unified\n * Provider<DappRpcTypes> regardless of the underlying wallet type.\n *\n * It is UI-framework agnostic — the wallet picker UI is injected\n * via the `walletPicker` config option.\n *\n * Client-level events (`discovery:connected`, `discovery:disconnected`,\n * `discovery:error`) track the adapter session lifecycle. Provider-level\n * CIP-103 events (statusChanged, accountsChanged, txChanged) live on\n * the Provider — subscribe via `client.getProvider().on(...)`.\n */\nexport class DiscoveryClient {\n private adapters = new Map<ProviderId, ProviderAdapter>()\n private events = new EventEmitter()\n private session: ActiveSession | null = null\n private config: DiscoveryClientConfig\n\n private constructor(config: DiscoveryClientConfig) {\n this.config = config\n }\n\n /**\n * Create and initialize a DiscoveryClient:\n * register configured adapters and attempt session restore.\n */\n static async create(\n config: DiscoveryClientConfig\n ): Promise<DiscoveryClient> {\n const client = new DiscoveryClient(config)\n await client.initialize()\n return client\n }\n\n private async initialize(): Promise<void> {\n if (this.config.adapters) {\n for (const adapter of this.config.adapters) {\n this.adapters.set(adapter.providerId, adapter)\n }\n }\n\n await this.tryRestore()\n }\n\n private async tryRestore(): Promise<void> {\n const persisted = loadPersistedSession()\n if (!persisted) return\n\n const adapter = this.adapters.get(persisted.providerId)\n if (!adapter?.restore) return\n\n try {\n const provider = await adapter.restore()\n if (provider) {\n this.session = {\n providerId: adapter.providerId,\n adapter,\n provider,\n }\n this.events.emit('discovery:connected', {\n providerId: adapter.providerId,\n })\n } else {\n clearPersistedSession()\n }\n } catch {\n clearPersistedSession()\n }\n }\n\n // ── Adapter management ─────────────────────────────────\n\n registerAdapter(adapter: ProviderAdapter): void {\n this.adapters.set(adapter.providerId, adapter)\n }\n\n listAdapters(): ProviderAdapter[] {\n return Array.from(this.adapters.values())\n }\n\n listWallets(): WalletInfo[] {\n return this.listAdapters().map((a) => a.getInfo())\n }\n\n // ── Connection lifecycle ───────────────────────────────\n\n /**\n * Connect to a wallet.\n * - If `providerId` is provided, connects directly to that wallet.\n * - If omitted and a `walletPicker` was configured, opens the picker.\n * - If omitted and no picker is configured, throws.\n */\n async connect(providerId?: ProviderId | undefined): Promise<void> {\n let targetId = providerId\n\n if (!targetId) {\n if (!this.config.walletPicker) {\n throw new DiscoveryError(\n 'INTERNAL_ERROR',\n 'No providerId provided and no walletPicker configured'\n )\n }\n\n const entries = this.listAdapters().map((a) => {\n const info = a.getInfo()\n return {\n providerId: info.providerId as string,\n name: info.name,\n type: info.type,\n description: info.description,\n icon: info.icon,\n url: info.url,\n }\n })\n\n const picked = await this.config.walletPicker(entries)\n targetId = picked.providerId\n }\n\n if (!targetId) {\n throw new DiscoveryError(\n 'INTERNAL_ERROR',\n 'No providerId selected from wallet picker'\n )\n }\n\n const adapter = this.adapters.get(targetId)\n if (!adapter) throw new WalletNotFoundError(targetId)\n\n try {\n const provider = adapter.provider()\n await provider.request({ method: 'connect' })\n this.session = { providerId: targetId, adapter, provider }\n persistSession(targetId)\n this.events.emit('discovery:connected', { providerId: targetId })\n } catch (err) {\n this.events.emit('discovery:error', {\n code:\n err instanceof DiscoveryError ? err.code : 'INTERNAL_ERROR',\n message:\n err instanceof Error ? err.message : 'Connection failed',\n cause: err,\n })\n throw err\n }\n }\n\n async disconnect(): Promise<void> {\n if (!this.session) return\n\n const { providerId, adapter, provider } = this.session\n try {\n await provider.request({ method: 'disconnect' })\n } finally {\n adapter.teardown()\n this.session = null\n clearPersistedSession()\n this.events.emit('discovery:disconnected', { providerId })\n }\n }\n\n getActiveSession(): ActiveSession | null {\n return this.session\n }\n\n // ── Provider access ────────────────────────────────────\n\n getProvider(): Provider<DappRpcTypes> {\n if (!this.session) throw new NotConnectedError()\n return this.session.provider\n }\n\n // ── Events ─────────────────────────────────────────────\n\n on<K extends DiscoveryClientEventName>(\n event: K,\n handler: DiscoveryClientEventHandler<K>\n ): () => void {\n return this.events.on(event, handler)\n }\n\n removeListener<K extends DiscoveryClientEventName>(\n event: K,\n handler: DiscoveryClientEventHandler<K>\n ): void {\n this.events.removeListener(event, handler)\n }\n\n destroy(): void {\n this.events.removeAllListeners()\n this.session = null\n }\n}\n"]}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import { ProviderId } from '@canton-network/core-wallet-dapp-rpc-client';
|
|
2
|
+
export declare const persistSession: (providerId: ProviderId) => void;
|
|
3
|
+
export declare const loadPersistedSession: () => {
|
|
4
|
+
providerId: ProviderId;
|
|
5
|
+
} | null;
|
|
6
|
+
export declare const clearPersistedSession: () => void;
|
|
7
|
+
//# sourceMappingURL=storage.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,6CAA6C,CAAA;AAMxE,eAAO,MAAM,cAAc,GAAI,YAAY,UAAU,KAAG,IASvD,CAAA;AAED,eAAO,MAAM,oBAAoB,QAAO;IAAE,UAAU,EAAE,UAAU,CAAA;CAAE,GAAG,IAQpE,CAAA;AAED,eAAO,MAAM,qBAAqB,QAAO,IAExC,CAAA"}
|
package/dist/types.d.ts
ADDED
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import type { Provider } from '@canton-network/core-splice-provider';
|
|
2
|
+
import type { WalletPickerEntry, WalletPickerResult } from '@canton-network/core-types';
|
|
3
|
+
export type { WalletPickerEntry, WalletPickerResult, } from '@canton-network/core-types';
|
|
4
|
+
import type { ProviderId, ProviderType, RpcTypes as DappRpcTypes } from '@canton-network/core-wallet-dapp-rpc-client';
|
|
5
|
+
export interface WalletInfo {
|
|
6
|
+
providerId: ProviderId;
|
|
7
|
+
name: string;
|
|
8
|
+
type: ProviderType;
|
|
9
|
+
description?: string | undefined;
|
|
10
|
+
icon?: string | undefined;
|
|
11
|
+
url?: string | undefined;
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* A ProviderAdapter is a thin factory that knows how to create a
|
|
15
|
+
* Provider<DappRpcTypes> for a particular wallet type, detect its
|
|
16
|
+
* availability, and clean up resources.
|
|
17
|
+
*
|
|
18
|
+
* All RPC methods (connect, disconnect, status, prepareExecute, etc.)
|
|
19
|
+
* are called directly on the provider — the adapter does not duplicate them.
|
|
20
|
+
*/
|
|
21
|
+
export interface ProviderAdapter {
|
|
22
|
+
readonly providerId: ProviderId;
|
|
23
|
+
readonly name: string;
|
|
24
|
+
readonly type: ProviderType;
|
|
25
|
+
readonly icon?: string | undefined;
|
|
26
|
+
/** Return wallet metadata for display in the wallet picker. */
|
|
27
|
+
getInfo(): WalletInfo;
|
|
28
|
+
/**
|
|
29
|
+
* Check whether this wallet is currently available.
|
|
30
|
+
* Extensions probe for the browser extension; gateways always return true.
|
|
31
|
+
*/
|
|
32
|
+
detect(): Promise<boolean>;
|
|
33
|
+
/**
|
|
34
|
+
* Return a Provider<DappRpcTypes> for this wallet.
|
|
35
|
+
* Extension adapters return a DappProvider (openrpc-dapp-api.json).
|
|
36
|
+
* Remote adapters may return a provider that bridges the
|
|
37
|
+
* remote API to the dApp API surface.
|
|
38
|
+
*
|
|
39
|
+
* The caller is responsible for invoking `provider.request({ method: 'connect' })`
|
|
40
|
+
* and `provider.request({ method: 'disconnect' })`.
|
|
41
|
+
*/
|
|
42
|
+
provider(): Provider<DappRpcTypes>;
|
|
43
|
+
/**
|
|
44
|
+
* Clean up adapter-specific resources (e.g. close popup windows).
|
|
45
|
+
* Called after disconnect. Does NOT call disconnect on the provider.
|
|
46
|
+
*/
|
|
47
|
+
teardown(): void;
|
|
48
|
+
/**
|
|
49
|
+
* Attempt to restore a previous session (e.g. from localStorage).
|
|
50
|
+
* Returns a ready-to-use provider if the session was restored, or null.
|
|
51
|
+
*/
|
|
52
|
+
restore?(): Promise<Provider<DappRpcTypes> | null>;
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* A function that presents wallet choices to the user and returns their selection.
|
|
56
|
+
* This abstraction allows the DiscoveryClient to remain UI-framework agnostic.
|
|
57
|
+
*/
|
|
58
|
+
export type WalletPickerFn = (entries: WalletPickerEntry[]) => Promise<WalletPickerResult>;
|
|
59
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAA;AACpE,OAAO,KAAK,EACR,iBAAiB,EACjB,kBAAkB,EACrB,MAAM,4BAA4B,CAAA;AACnC,YAAY,EACR,iBAAiB,EACjB,kBAAkB,GACrB,MAAM,4BAA4B,CAAA;AACnC,OAAO,KAAK,EACR,UAAU,EACV,YAAY,EACZ,QAAQ,IAAI,YAAY,EAC3B,MAAM,6CAA6C,CAAA;AAEpD,MAAM,WAAW,UAAU;IACvB,UAAU,EAAE,UAAU,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,YAAY,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC3B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAElC,+DAA+D;IAC/D,OAAO,IAAI,UAAU,CAAA;IAErB;;;OAGG;IACH,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IAE1B;;;;;;;;OAQG;IACH,QAAQ,IAAI,QAAQ,CAAC,YAAY,CAAC,CAAA;IAElC;;;OAGG;IACH,QAAQ,IAAI,IAAI,CAAA;IAEhB;;;OAGG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,CAAA;CACrD;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CACzB,OAAO,EAAE,iBAAiB,EAAE,KAC3B,OAAO,CAAC,kBAAkB,CAAC,CAAA"}
|
package/package.json
ADDED
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@canton-network/core-wallet-discovery",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"type": "module",
|
|
5
|
+
"description": "Wallet discovery, adapter pattern, and session management for the Canton Network.",
|
|
6
|
+
"license": "Apache-2.0",
|
|
7
|
+
"author": "Marc Juchli <marc.juchli@digitalasset.com>",
|
|
8
|
+
"main": "./dist/index.cjs",
|
|
9
|
+
"module": "./dist/index.js",
|
|
10
|
+
"types": "./dist/index.d.ts",
|
|
11
|
+
"exports": {
|
|
12
|
+
".": {
|
|
13
|
+
"types": "./dist/index.d.ts",
|
|
14
|
+
"import": "./dist/index.js",
|
|
15
|
+
"require": "./dist/index.cjs",
|
|
16
|
+
"default": "./dist/index.js"
|
|
17
|
+
}
|
|
18
|
+
},
|
|
19
|
+
"scripts": {
|
|
20
|
+
"build": "tsup && tsc -p tsconfig.types.json",
|
|
21
|
+
"dev": "tsup --watch --onSuccess \"tsc -p tsconfig.types.json\"",
|
|
22
|
+
"flatpack": "yarn pack --out \"$FLATPACK_OUTDIR\"",
|
|
23
|
+
"clean": "tsc -b --clean; rm -rf dist"
|
|
24
|
+
},
|
|
25
|
+
"dependencies": {
|
|
26
|
+
"@canton-network/core-splice-provider": "^0.25.0",
|
|
27
|
+
"@canton-network/core-types": "^0.19.0",
|
|
28
|
+
"@canton-network/core-wallet-dapp-rpc-client": "^0.24.0"
|
|
29
|
+
},
|
|
30
|
+
"devDependencies": {
|
|
31
|
+
"tsup": "^8.5.1",
|
|
32
|
+
"typescript": "^5.9.3"
|
|
33
|
+
},
|
|
34
|
+
"files": [
|
|
35
|
+
"dist/**"
|
|
36
|
+
],
|
|
37
|
+
"publishConfig": {
|
|
38
|
+
"access": "public"
|
|
39
|
+
},
|
|
40
|
+
"repository": {
|
|
41
|
+
"type": "git",
|
|
42
|
+
"url": "git+https://github.com/hyperledger-labs/splice-wallet-kernel.git",
|
|
43
|
+
"directory": "core/wallet-discovery"
|
|
44
|
+
}
|
|
45
|
+
}
|