@cantor8/wallet-connect-sdk 0.3.0-alpha.1

package/README.md

@@ -0,0 +1,90 @@
+
+# C8 Wallet Connect SDK
+
+Lightweight SDK for dApp developers to integrate the C8 Wallet via a popup window and postMessage communication.
+
+Quick start
+
+
+## Configuration
+
+You can configure the provider construction:
+
+```
+const c8 = new C8WalletProvider({
+    dappUrl: window.location.href,
+    dappName: "Cantor8 Wallet Connect SDK Demo",
+    network: "devnet"
+});
+```
+
+Sign up for events:
+
+``` 
+c8.on('connected', (e) => console.log('Connected', e));
+c8.on('disconnected', (e) => console.log('Disconnected', e));
+c8.on('accountChanged', (e) => console.log('account's balance changed', e));
+c8.on('txInitiated', (e) => console.log('TX initiated', e));
+c8.on('txChanged', (e) => console.log('TX changed', e));
+```
+    
+Basic usage
+
+```
+ const c8 = new C8WalletProvider({
+    dappUrl: window.location.href,
+    dappName: "Cantor8 Wallet Connect SDK Demo",
+    network: "devnet"
+});
+
+await c8.connect();
+
+// Instruments list type: InstrumentListPayload
+const instruments = await c8.getInstruments();
+console.log('Instruments', instruments);
+
+const firstInstrumentId = instruments.instruments[0]?.instrumentId;
+
+// Accounts list type: AccountListPayload
+const accounts = await wallet.getAccounts(firstInstrumentId);
+console.log('Accounts', accounts);
+
+const senderPartyId = accounts.accounts[0]?.partyId;
+const senderHoldingInstrumentId = accounts.accounts[0]?.holdings[0]?.instrumentId || firstInstrumentId;
+
+// Submit a transfer
+// SubmitTransferResultPayload
+const res = await c8.send({
+    senderPartyId,
+    instrumentId: senderHoldingInstrumentId,
+    amount: 1.23,
+    receiverPartyId: 'Party::Receiver',
+});
+console.log('Send result', res); // { txId }
+```
+## API Reference
+
+#### Public API (Provider)
+
+|  | 
+| :-------- | 
+| `connect(): Promise<void>` | 
+| `disconnect(): Promise<void>` | 
+| `status(): Promise<{connected: boolean, walletVersion?: string}>` | 
+| `getInstruments(): Promise<InstrumentListPayload>` | 
+| `getAccounts(instrumentId?: string):  Promise<AccountListPayload>` | 
+| `send(input: {senderPartyId: string, instrumentId: string, amount: number, receiverPartyId: string, memo?: string, metadata?: Record<string, string>}): Promise<SubmitTransferResultPayload>` | 
+| `checkTxStatusById(input: {partyId: string, txId: string}): Promise<TransferStatusResponsePayload>` | 
+
+#### Events
+
+|  | 
+| :-------- | 
+| `connected` |
+| `disconnected` | 
+| `accountChanged` |
+| `txInitiated` | 
+| `txChanged` | 
+
+
+

package/dist/discovery.d.ts

@@ -0,0 +1,8 @@
+export type C8ProviderInfo = {
+    uuid: string;
+    name: "C8 Wallet";
+    icon: string;
+    rdns: "tech.cantor8.wallet";
+};
+export declare function announceC8Provider(get: () => any): void;
+export declare function onC8ProviderDiscovered(cb: (info: C8ProviderInfo, provider: any) => void): () => void;

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";const e="https://wallet.dev.digik.cantor8.tech",t="https://wallet-backend.dev.digik.cantor8.tech";class s{static getItem(e){try{const t=localStorage.getItem(e);return t?JSON.parse(t):null}catch(e){return null}}static setItem(e,t){try{localStorage.setItem(e,JSON.stringify(t))}catch(e){}}static removeItem(e){try{localStorage.removeItem(e)}catch(e){}}}const n={TestCoin1:"TestCoin1",Amulet:"Canton Coin",CBTC:"CBTC",USDCx:"USDCx",CETH:"CETH"},i=e=>{var t;return"Amulet"===e?"Canton Coin":null!=(t=n[null!=e?e:""])?t:e},r={TestCoin1:"TestCoin1",Amulet:"CC",CBTC:"CBTC",USDCx:"USDCx"},a=e=>{var t;return"Amulet"===e?"CC":null!=(t=r[null!=e?e:""])?t:e};var o=Object.defineProperty,h=(e,t,s)=>((e,t,s)=>t in e?o(e,t,{enumerable:!0,configurable:!0,writable:!0,value:s}):e[t]=s)(e,"symbol"!=typeof t?t+"":t,s);const d=class e{constructor(){h(this,"appName"),h(this,"accounts",[]),h(this,"instruments",[]),h(this,"partyIds",[]),h(this,"authToken",null),h(this,"isConnected",!1),h(this,"expireAt",null),h(this,"disconnectTimeoutId",null),this.load()}static getInstance(){return e.instance||(e.instance=new e),e.instance}setAppName(e){this.appName=e}getAppName(){return this.appName}setInstruments(e){this.instruments=e}getInstruments(){return this.instruments}setAccounts(e){this.accounts=e,this.partyIds=e.map(e=>e.partyId),this.instruments=e.flatMap(e=>e.holdings.map(e=>({instrumentId:e.instrumentId,name:i(e.instrumentId),symbol:a(e.instrumentId)})))}getAccounts(){return this.accounts}setBearerToken(e,t){this.authToken=e,this.isConnected=!0,this.expireAt=t}getExpireAt(){return this.expireAt}setDisconnectTimeoutId(e){this.disconnectTimeoutId&&clearTimeout(this.disconnectTimeoutId),this.disconnectTimeoutId=e}getDisconnectTimeoutId(){return this.disconnectTimeoutId}getBearerToken(){return this.authToken}clear(){this.accounts=[],this.instruments=[],this.authToken=null,this.partyIds=[],this.isConnected=!1,this.expireAt=null,this.disconnectTimeoutId&&(clearTimeout(this.disconnectTimeoutId),this.disconnectTimeoutId=null),s.removeItem(e.SESSION_KEY)}save(){s.setItem(e.SESSION_KEY,{authToken:this.authToken,partyIds:this.partyIds,expireAt:this.expireAt})}setConnected(e){this.isConnected=e}getConnected(){return this.isConnected}hasStoredSession(){return!!s.getItem(e.SESSION_KEY)}load(){const t=s.getItem(e.SESSION_KEY);t&&(this.authToken=t.authToken,this.partyIds=t.partyIds||[],this.expireAt=t.expireAt||null)}};h(d,"instance"),h(d,"SESSION_KEY","c8-session");let c=d;var l=Object.defineProperty,u=(e,t,s)=>((e,t,s)=>t in e?l(e,t,{enumerable:!0,configurable:!0,writable:!0,value:s}):e[t]=s)(e,"symbol"!=typeof t?t+"":t,s);const p=class e{constructor(e=5e3){this.pollingInterval=e,u(this,"events",new Map),u(this,"intervals",new Map),u(this,"handlerRegistry",new Map),this.restore()}static getInstance(t=5e3){return e.instance||(e.instance=new e(t)),e.instance}registerHandler(e,t){this.handlerRegistry.set(e,t),this.events.forEach((s,n)=>{s.event.type===e&&(this.stopPolling(n),s.handler=t,this.startPolling(n))})}add(e,t){const s=btoa(`${e}-${JSON.stringify(t)}`);this.events.has(s)&&this.remove(s);const n=this.handlerRegistry.get(e);if(!n)return;const i={key:s,type:e,params:t,createdAt:Date.now()};this.events.set(s,{event:i,handler:n}),this.persist(),this.startPolling(s)}remove(e){this.stopPolling(e),this.events.delete(e),this.persist()}startPolling(t){const s=this.events.get(t);if(!s)return;const{event:n,handler:i}=s,r=async()=>{try{if(n.createdAt&&Date.now()-n.createdAt>e.POLLING_TIMEOUT)return void this.remove(t);await i(n.params)&&this.remove(t)}catch(e){}};r();const a=window.setInterval(r,this.pollingInterval);this.intervals.set(t,a)}stopPolling(e){const t=this.intervals.get(e);void 0!==t&&(window.clearInterval(t),this.intervals.delete(e))}persist(){const t=Array.from(this.events.values()).map(e=>e.event);s.setItem(e.STORAGE_KEY,t)}restore(){const t=s.getItem(e.STORAGE_KEY);if(t&&Array.isArray(t)){const s=Date.now();t.forEach(t=>{if(t.createdAt&&s-t.createdAt>e.POLLING_TIMEOUT)return;const n=this.handlerRegistry.get(t.key);n?(this.events.set(t.key,{event:t,handler:n}),this.startPolling(t.key)):this.events.set(t.key,{event:t,handler:async()=>!1})})}}clear(){this.events.clear(),this.intervals.forEach(e=>window.clearInterval(e)),this.intervals.clear(),this.persist(),s.removeItem(e.STORAGE_KEY)}getEvents(){return Array.from(this.events.values()).map(e=>e.event)}};u(p,"EVENT_TYPES",{RESTORE_SESSION:"RESTORE_SESSION",TRACK_TX_STATUS:"TRACK_TX_STATUS",UPDATE_ACCOUNT:"UPDATE_ACCOUNT"}),u(p,"type"),u(p,"instance"),u(p,"STORAGE_KEY","c8-polling-events"),u(p,"POLLING_TIMEOUT",3e5);let m=p;var g=Object.defineProperty;class v{constructor(e){((e,t,s)=>{((e,t,s)=>{t in e?g(e,t,{enumerable:!0,configurable:!0,writable:!0,value:s}):e[t]=s})(e,t+"",s)})(this,"baseUrl"),this.baseUrl=e.endsWith("/")?e.slice(0,-1):e}async request(e,t={}){const s=c.getInstance().getBearerToken(),n=c.getInstance().getAppName(),i=new Headers(t.headers);s&&(i.set("Authorization",`Bearer ${s}`),i.set("X-App-Name",null!=n?n:"Unknown App")),i.set("x-feat-decimals","1");const r=await fetch(`${this.baseUrl}${e}`,{...t,headers:i});if(!r.ok)throw new Error(`HTTP error! status: ${r.status}`);return await r.json()}async getBalance(){return this.request("/api/balance")}async getTransferStatus(e){return this.request(`/api/transfer/status?command_id=${e}`)}}var T=Object.defineProperty,I=(e,t,s)=>((e,t,s)=>t in e?T(e,t,{enumerable:!0,configurable:!0,writable:!0,value:s}):e[t]=s)(e,"symbol"!=typeof t?t+"":t,s);function f(){let e,t;return{promise:new Promise((s,n)=>{e=s,t=n}),resolve:e,reject:t}}class w{constructor(s,n,i=e){let r;switch(this.appName=s,this.appUrl=n,this.origin=i,I(this,"WINDOW_NAME","c8-wallet"),I(this,"WINDOW_WIDTH",475),I(this,"WINDOW_HEIGHT",762),I(this,"popup"),I(this,"sessionId",crypto.randomUUID()),I(this,"listening",!1),I(this,"walletReady",!1),I(this,"pending",new Map),I(this,"eventHandlers",new Set),I(this,"handshakeTimer"),I(this,"handshakeDeadline"),I(this,"closeWatcherTimer"),I(this,"pollingManager",m.getInstance()),I(this,"session",c.getInstance()),I(this,"initDeferred"),I(this,"httpClient"),this.onWindowMessage=this.onWindowMessage.bind(this),this.handleRestoreSession=this.handleRestoreSession.bind(this),this.handleTrackTxStatus=this.handleTrackTxStatus.bind(this),this.handleAccountUpdate=this.handleAccountUpdate.bind(this),this.session.setAppName(this.appName),this.attachListener(),this.origin){case e:r=t;break;case"https://wallet.cantor8.tech":case"https://wallet.main.digik.cantor8.tech":r="https://wallet-backend.main.cantor8.tech";break;default:r=t}this.httpClient=new v(r),this.pollingManager.registerHandler(m.EVENT_TYPES.RESTORE_SESSION,this.handleRestoreSession),this.pollingManager.registerHandler(m.EVENT_TYPES.TRACK_TX_STATUS,this.handleTrackTxStatus),this.pollingManager.registerHandler(m.EVENT_TYPES.UPDATE_ACCOUNT,this.handleAccountUpdate),this.checkRestoreSession()}checkRestoreSession(){this.session.hasStoredSession()&&this.pollingManager.add(m.EVENT_TYPES.RESTORE_SESSION,{sessionId:this.sessionId})}async handleAccountUpdate(e){try{const e=await this.httpClient.getBalance();if(e&&e.holdings){const t=[{partyId:e.party_id,holdings:Object.entries(e.holdings).map(([e,t])=>({instrumentId:e,balance:Number(t.balance),balanceUsd:Number(t.balance_usd)}))}];this.session.setAccounts(t),this.session.save()}return!0}catch(e){e instanceof Error&&e.message.includes("401")&&this.destroy()}return!1}async getTransferStatusById(e){try{const t=await this.httpClient.getTransferStatus(e);let s;switch(t.status){case"success":s="confirmed";break;case"failed":s="failed";break;default:s="pending"}return t.status=s,t}catch(e){return e instanceof Error&&e.message.includes("401")&&this.destroy(),null}}async handleTrackTxStatus(e){try{const t=await this.httpClient.getTransferStatus(e.txId);if(e.status!==t.status){let s;switch(t.status){case"success":s="confirmed";break;case"failed":s="failed";break;default:s="pending"}return this.emitSyntheticEvent({type:"txChanged",txId:e.txId,status:s}),e.status=t.status,this.pollingManager.persist(),"pending"!==t.status&&this.pollingManager.add(m.EVENT_TYPES.UPDATE_ACCOUNT,{txId:e.txId}),"success"===t.status||"failed"===t.status}}catch(t){if(t instanceof Error&&(t.message.includes("401")&&this.destroy(),t.message.includes("404")))return this.emitSyntheticEvent({type:"txChanged",txId:e.txId,status:"failed"}),!0}return!1}async handleRestoreSession(e){try{const e=await this.httpClient.getBalance();if(e&&e.holdings){const t=[{partyId:e.party_id,holdings:Object.entries(e.holdings).map(([e,t])=>({instrumentId:e,balance:Number(t.balance),balanceUsd:Number(t.balance_usd)}))}];this.session.setAccounts(t),this.session.save(),this.session.setConnected(!0),this.emitSyntheticEvent({type:"connected"});const s=this.session.getExpireAt();return s&&this.scheduleDisconnect(s),!0}}catch(e){e instanceof Error&&e.message.includes("401")&&this.destroy()}return!1}get WALLET_EMBEDDED(){return`${this.origin}/embedded/`}async init(e){var t;if(void 0!==this.popup&&(null==(t=this.popup)||!t.closed))return;if(this.initDeferred||(this.initDeferred=f()),this.listening||this.attachListener(),this.popup&&!this.popup.closed)return this.popup.focus(),null==this.handshakeTimer&&this.startHandshakeLoop(),this.initDeferred.promise;const s=new URL(null!=e?e:"",this.WALLET_EMBEDDED);if(this.popup=window.open(s,this.WINDOW_NAME,`width=${this.WINDOW_WIDTH},height=${this.WINDOW_HEIGHT}`),!this.popup){const e=new Error("Failed to open popup window");Object.assign(e,{code:"POPUP_BLOCKED",message:"browser blocked the popup window"}),this.rejectInit(e)}return this.startHandshakeLoop(),this.initDeferred.promise}emitSyntheticEvent(e){for(const t of this.eventHandlers)try{t({kind:"event",event:e})}catch(e){}}scheduleDisconnect(e){if(!e)return;const t=e-Date.now();if(t>0){const e=setTimeout(()=>{this.destroy("authToken expired")},t);this.session.setDisconnectTimeoutId(e)}else this.destroy("authToken expired")}destroy(e="destroyed"){try{this.emitSyntheticEvent({type:"disconnected",reason:e}),this.detachListener(),this.clearHandshakeLoop(),this.initDeferred&&(this.initDeferred.reject(new Error("Transport destroyed")),this.initDeferred=void 0);for(const[,e]of this.pending)e.reject(new Error("Transport destroyed"));this.pending.clear(),this.popup&&!this.popup.closed&&this.popup.close(),this.popup=void 0,this.walletReady=!1,this.session.clear(),this.pollingManager.clear()}catch(e){}}async request(e,t,s){var n,i,r,a,o,h,d,c,l,u,p,m,g,v,T,I;const w=crypto.randomUUID(),E=f();this.pending.set(w,E);try{if("connect"===e){if(this.session.getBearerToken())return this.handleResponse({kind:"response",id:w,result:null}),E.promise;this.session.getBearerToken()||(this.walletReady=!1),await this.init()}if("send"===e&&(this.walletReady=!1,await this.init("confirmTransaction")),"signAndExecute"===e&&(this.walletReady=!1,await this.init("signAndExecute")),"status"===e)return this.handleResponse({kind:"response",id:w,result:{connected:this.session.getConnected(),walletVersion:void 0}}),E.promise;if(s&&(null==(n=this.popup)||n.focus()),"getInstruments"===e){const e=this.session.getInstruments();return this.handleResponse({kind:"response",id:w,result:{instruments:e}}),E.promise}if("getAccounts"===e){await this.handleAccountUpdate();const e=this.session.getAccounts();return this.handleResponse({kind:"response",id:w,result:{accounts:e}}),E.promise}if("checkTxStatusById"===e){const e=t,s=await this.getTransferStatusById(null==e?void 0:e.txId);if(s){const e={status:s.status,transfer:{senderPartyId:null!=(r=null==(i=s.transfer)?void 0:i.party_id)?r:"",receiverPartyId:null!=(o=null==(a=s.transfer)?void 0:a.party_id2)?o:"",amount:Number(null!=(d=null==(h=s.transfer)?void 0:h.amount)?d:"0"),networkFees:Number(null!=(l=null==(c=s.transfer)?void 0:c.network_fees)?l:"0"),instrumentId:null!=(p=null==(u=s.transfer)?void 0:u.instrument_id)?p:"",txId:null!=(g=null==(m=s.transfer)?void 0:m.command_id)?g:"",created_at:null!=(T=null==(v=s.transfer)?void 0:v.created_at)?T:"",memo:null==(I=s.transfer)?void 0:I.reason}};this.handleResponse({kind:"response",id:w,result:e})}else this.handleResponse({kind:"response",id:w,error:{code:"FAILED_TO_FETCH_TRANSFER_STATUS",message:"Failed to fetch transfer status"}});return E.promise}if("disconnect"===e)return this.handleResponse({kind:"response",id:w,result:null}),E.promise;const f={kind:"request",id:w,method:e,params:t,sessionId:this.sessionId};this.post(f)}catch(e){this.pending.delete(w),E.reject(e)}return E.promise}onEvent(e){return this.eventHandlers.add(e),()=>{this.eventHandlers.delete(e)}}attachListener(){this.listening||(window.addEventListener("message",this.onWindowMessage),this.listening=!0)}detachListener(){this.listening&&(window.removeEventListener("message",this.onWindowMessage),this.listening=!1)}post(e){try{if(!this.popup||this.popup.closed)return;this.popup.postMessage(e,this.origin)}catch(e){}}onWindowMessage(e){if(e.origin!==this.origin)return;const t=e.data;if(t&&"object"==typeof t){if("event"===t.kind){for(const e of this.eventHandlers)"txInitiated"===t.event.type&&this.pollingManager.add(m.EVENT_TYPES.TRACK_TX_STATUS,{txId:t.event.txId,status:"initiated"}),e(t);return}if("internal_event"===t.kind)return void this.pollingManager.add(t.event.type,{wop:"wopwop"});if("auth-flow"===t.kind&&(this.session.setBearerToken(t.token,t.expireAt),this.session.setAccounts(t.accounts),this.session.setInstruments(t.instruments),this.session.save(),this.scheduleDisconnect(t.expireAt)),"handshake-ack"===t.kind&&t.ok)return void this.handleHandshakeAck();"response"===t.kind&&this.handleResponse(t)}}handleHandshakeAck(){this.walletReady=!0,this.clearHandshakeLoop(),this.initDeferred&&(this.initDeferred.resolve(),this.initDeferred=void 0)}handleResponse(e){const t=this.pending.get(e.id);if(t)if(this.pending.delete(e.id),e.error){const s=new Error(e.error.message||"Unknown Error");Object.assign(s,{code:e.error.code,data:e.error.data}),t.reject(s)}else t.resolve(e.result)}startHandshakeLoop(){this.handshakeDeadline=Date.now()+55e3;const e=()=>{if(!this.walletReady)return!this.popup||this.popup.closed?(this.clearHandshakeLoop(),void this.rejectInit(new Error("Popup closed before handshake"))):this.handshakeDeadline&&Date.now()>this.handshakeDeadline?(this.clearHandshakeLoop(),void this.rejectInit(new Error("Handshake timed out"))):void this.post({kind:"handshake",sdkVersion:"0.0.0",sessionId:this.sessionId,dapp:{name:this.appName,url:this.appUrl}});this.clearHandshakeLoop()};e(),this.handshakeTimer=window.setInterval(e,300)}clearHandshakeLoop(){null!=this.handshakeTimer&&(clearInterval(this.handshakeTimer),this.handshakeTimer=void 0),this.handshakeDeadline=void 0}rejectInit(e){this.initDeferred&&(Object.assign(e,{code:"INITIALIZATION_FAILED",message:e.message}),this.initDeferred.reject(e),this.initDeferred=void 0)}startPopupClosedWatcher(){const e=this.popup;if(!e)return;const t=window.setInterval(()=>{(!e||e.closed)&&(clearInterval(t),this.destroy())},300);this.closeWatcherTimer=t}}var E=Object.defineProperty,y=(e,t,s)=>((e,t,s)=>t in e?E(e,t,{enumerable:!0,configurable:!0,writable:!0,value:s}):e[t]=s)(e,"symbol"!=typeof t?t+"":t,s);const k={uuid:"c8-wallet-connect",name:"C8 Wallet",icon:"",rdns:"tech.cantor8.wallet"},S="c8#provider_discovery";exports.C8WalletProvider=class{constructor(t){var s,n,i;y(this,"transport"),y(this,"listeners",{});const r=null!=(s=t.dappName)?s:document.title||"Unknown dApp",a=null!=(n=t.dappUrl)?n:location.origin,o=null!=(i=t.network)?i:"mainnet";let h;if("devnet"!==o)throw new Error("Only devnet network is supported right now");if("devnet"!==o)throw new Error("Unsupported network: "+o);h=e,this.transport=new w(r,a,h),this.transport.onEvent(e=>{"event"===e.kind&&this.emit(e.event.type,e.event)})}async connect(){await this.transport.request("connect",void 0,!0)}async disconnect(){try{await this.transport.request("disconnect"),this.transport.destroy()}catch(e){}}status(){return this.transport.request("status")}getInstruments(){return this.transport.request("getInstruments")}getAccounts(e){return this.transport.request("getAccounts",{instrumentId:e})}send(e){return this.transport.request("send",e,!0)}signAndExecute(e){return this.transport.request("signAndExecute",e,!0)}signAndExecutePreparedTransfer(e){return this.transport.request("signAndExecutePreparedTransfer",e,!0)}acknowledge(e){return this.transport.request("acknowledge",e,!0)}checkTxStatusById(e){return this.transport.request("checkTxStatusById",e)}on(e,t){return this.listeners[e]||(this.listeners[e]=new Set),this.listeners[e].add(t),()=>this.listeners[e].delete(t)}emit(e,t){var s;for(const n of null!=(s=this.listeners[e])?s:[])n(t)}},exports.HttpClient=v,exports.LocalStorageHelper=s,exports.announceC8Provider=function(e){const t={info:k,provider:e()};window.dispatchEvent(new CustomEvent(S,{detail:t}))},exports.onC8ProviderDiscovered=function(e){const t=t=>{const s=t;s.detail&&e(s.detail.info,s.detail.provider)};return window.addEventListener(S,t),()=>window.removeEventListener(S,t)};

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./provider";
+export * from "./discovery";
+export * from "./types";
+export * from "./utils/storage";
+export * from "./utils/HttpClient";

package/dist/index.esm.js

@@ -0,0 +1 @@
+const e="https://wallet.dev.digik.cantor8.tech",t="https://wallet-backend.dev.digik.cantor8.tech";class s{static getItem(e){try{const t=localStorage.getItem(e);return t?JSON.parse(t):null}catch(e){return null}}static setItem(e,t){try{localStorage.setItem(e,JSON.stringify(t))}catch(e){}}static removeItem(e){try{localStorage.removeItem(e)}catch(e){}}}const n={TestCoin1:"TestCoin1",Amulet:"Canton Coin",CBTC:"CBTC",USDCx:"USDCx",CETH:"CETH"},i=e=>{var t;return"Amulet"===e?"Canton Coin":null!=(t=n[null!=e?e:""])?t:e},r={TestCoin1:"TestCoin1",Amulet:"CC",CBTC:"CBTC",USDCx:"USDCx"},a=e=>{var t;return"Amulet"===e?"CC":null!=(t=r[null!=e?e:""])?t:e};var o=Object.defineProperty,h=(e,t,s)=>((e,t,s)=>t in e?o(e,t,{enumerable:!0,configurable:!0,writable:!0,value:s}):e[t]=s)(e,"symbol"!=typeof t?t+"":t,s);const d=class e{constructor(){h(this,"appName"),h(this,"accounts",[]),h(this,"instruments",[]),h(this,"partyIds",[]),h(this,"authToken",null),h(this,"isConnected",!1),h(this,"expireAt",null),h(this,"disconnectTimeoutId",null),this.load()}static getInstance(){return e.instance||(e.instance=new e),e.instance}setAppName(e){this.appName=e}getAppName(){return this.appName}setInstruments(e){this.instruments=e}getInstruments(){return this.instruments}setAccounts(e){this.accounts=e,this.partyIds=e.map(e=>e.partyId),this.instruments=e.flatMap(e=>e.holdings.map(e=>({instrumentId:e.instrumentId,name:i(e.instrumentId),symbol:a(e.instrumentId)})))}getAccounts(){return this.accounts}setBearerToken(e,t){this.authToken=e,this.isConnected=!0,this.expireAt=t}getExpireAt(){return this.expireAt}setDisconnectTimeoutId(e){this.disconnectTimeoutId&&clearTimeout(this.disconnectTimeoutId),this.disconnectTimeoutId=e}getDisconnectTimeoutId(){return this.disconnectTimeoutId}getBearerToken(){return this.authToken}clear(){this.accounts=[],this.instruments=[],this.authToken=null,this.partyIds=[],this.isConnected=!1,this.expireAt=null,this.disconnectTimeoutId&&(clearTimeout(this.disconnectTimeoutId),this.disconnectTimeoutId=null),s.removeItem(e.SESSION_KEY)}save(){s.setItem(e.SESSION_KEY,{authToken:this.authToken,partyIds:this.partyIds,expireAt:this.expireAt})}setConnected(e){this.isConnected=e}getConnected(){return this.isConnected}hasStoredSession(){return!!s.getItem(e.SESSION_KEY)}load(){const t=s.getItem(e.SESSION_KEY);t&&(this.authToken=t.authToken,this.partyIds=t.partyIds||[],this.expireAt=t.expireAt||null)}};h(d,"instance"),h(d,"SESSION_KEY","c8-session");let c=d;var l=Object.defineProperty,u=(e,t,s)=>((e,t,s)=>t in e?l(e,t,{enumerable:!0,configurable:!0,writable:!0,value:s}):e[t]=s)(e,"symbol"!=typeof t?t+"":t,s);const p=class e{constructor(e=5e3){this.pollingInterval=e,u(this,"events",new Map),u(this,"intervals",new Map),u(this,"handlerRegistry",new Map),this.restore()}static getInstance(t=5e3){return e.instance||(e.instance=new e(t)),e.instance}registerHandler(e,t){this.handlerRegistry.set(e,t),this.events.forEach((s,n)=>{s.event.type===e&&(this.stopPolling(n),s.handler=t,this.startPolling(n))})}add(e,t){const s=btoa(`${e}-${JSON.stringify(t)}`);this.events.has(s)&&this.remove(s);const n=this.handlerRegistry.get(e);if(!n)return;const i={key:s,type:e,params:t,createdAt:Date.now()};this.events.set(s,{event:i,handler:n}),this.persist(),this.startPolling(s)}remove(e){this.stopPolling(e),this.events.delete(e),this.persist()}startPolling(t){const s=this.events.get(t);if(!s)return;const{event:n,handler:i}=s,r=async()=>{try{if(n.createdAt&&Date.now()-n.createdAt>e.POLLING_TIMEOUT)return void this.remove(t);await i(n.params)&&this.remove(t)}catch(e){}};r();const a=window.setInterval(r,this.pollingInterval);this.intervals.set(t,a)}stopPolling(e){const t=this.intervals.get(e);void 0!==t&&(window.clearInterval(t),this.intervals.delete(e))}persist(){const t=Array.from(this.events.values()).map(e=>e.event);s.setItem(e.STORAGE_KEY,t)}restore(){const t=s.getItem(e.STORAGE_KEY);if(t&&Array.isArray(t)){const s=Date.now();t.forEach(t=>{if(t.createdAt&&s-t.createdAt>e.POLLING_TIMEOUT)return;const n=this.handlerRegistry.get(t.key);n?(this.events.set(t.key,{event:t,handler:n}),this.startPolling(t.key)):this.events.set(t.key,{event:t,handler:async()=>!1})})}}clear(){this.events.clear(),this.intervals.forEach(e=>window.clearInterval(e)),this.intervals.clear(),this.persist(),s.removeItem(e.STORAGE_KEY)}getEvents(){return Array.from(this.events.values()).map(e=>e.event)}};u(p,"EVENT_TYPES",{RESTORE_SESSION:"RESTORE_SESSION",TRACK_TX_STATUS:"TRACK_TX_STATUS",UPDATE_ACCOUNT:"UPDATE_ACCOUNT"}),u(p,"type"),u(p,"instance"),u(p,"STORAGE_KEY","c8-polling-events"),u(p,"POLLING_TIMEOUT",3e5);let m=p;var g=Object.defineProperty;class v{constructor(e){((e,t,s)=>{((e,t,s)=>{t in e?g(e,t,{enumerable:!0,configurable:!0,writable:!0,value:s}):e[t]=s})(e,t+"",s)})(this,"baseUrl"),this.baseUrl=e.endsWith("/")?e.slice(0,-1):e}async request(e,t={}){const s=c.getInstance().getBearerToken(),n=c.getInstance().getAppName(),i=new Headers(t.headers);s&&(i.set("Authorization",`Bearer ${s}`),i.set("X-App-Name",null!=n?n:"Unknown App")),i.set("x-feat-decimals","1");const r=await fetch(`${this.baseUrl}${e}`,{...t,headers:i});if(!r.ok)throw new Error(`HTTP error! status: ${r.status}`);return await r.json()}async getBalance(){return this.request("/api/balance")}async getTransferStatus(e){return this.request(`/api/transfer/status?command_id=${e}`)}}var T=Object.defineProperty,I=(e,t,s)=>((e,t,s)=>t in e?T(e,t,{enumerable:!0,configurable:!0,writable:!0,value:s}):e[t]=s)(e,"symbol"!=typeof t?t+"":t,s);function f(){let e,t;return{promise:new Promise((s,n)=>{e=s,t=n}),resolve:e,reject:t}}class w{constructor(s,n,i=e){let r;switch(this.appName=s,this.appUrl=n,this.origin=i,I(this,"WINDOW_NAME","c8-wallet"),I(this,"WINDOW_WIDTH",475),I(this,"WINDOW_HEIGHT",762),I(this,"popup"),I(this,"sessionId",crypto.randomUUID()),I(this,"listening",!1),I(this,"walletReady",!1),I(this,"pending",new Map),I(this,"eventHandlers",new Set),I(this,"handshakeTimer"),I(this,"handshakeDeadline"),I(this,"closeWatcherTimer"),I(this,"pollingManager",m.getInstance()),I(this,"session",c.getInstance()),I(this,"initDeferred"),I(this,"httpClient"),this.onWindowMessage=this.onWindowMessage.bind(this),this.handleRestoreSession=this.handleRestoreSession.bind(this),this.handleTrackTxStatus=this.handleTrackTxStatus.bind(this),this.handleAccountUpdate=this.handleAccountUpdate.bind(this),this.session.setAppName(this.appName),this.attachListener(),this.origin){case e:r=t;break;case"https://wallet.cantor8.tech":case"https://wallet.main.digik.cantor8.tech":r="https://wallet-backend.main.cantor8.tech";break;default:r=t}this.httpClient=new v(r),this.pollingManager.registerHandler(m.EVENT_TYPES.RESTORE_SESSION,this.handleRestoreSession),this.pollingManager.registerHandler(m.EVENT_TYPES.TRACK_TX_STATUS,this.handleTrackTxStatus),this.pollingManager.registerHandler(m.EVENT_TYPES.UPDATE_ACCOUNT,this.handleAccountUpdate),this.checkRestoreSession()}checkRestoreSession(){this.session.hasStoredSession()&&this.pollingManager.add(m.EVENT_TYPES.RESTORE_SESSION,{sessionId:this.sessionId})}async handleAccountUpdate(e){try{const e=await this.httpClient.getBalance();if(e&&e.holdings){const t=[{partyId:e.party_id,holdings:Object.entries(e.holdings).map(([e,t])=>({instrumentId:e,balance:Number(t.balance),balanceUsd:Number(t.balance_usd)}))}];this.session.setAccounts(t),this.session.save()}return!0}catch(e){e instanceof Error&&e.message.includes("401")&&this.destroy()}return!1}async getTransferStatusById(e){try{const t=await this.httpClient.getTransferStatus(e);let s;switch(t.status){case"success":s="confirmed";break;case"failed":s="failed";break;default:s="pending"}return t.status=s,t}catch(e){return e instanceof Error&&e.message.includes("401")&&this.destroy(),null}}async handleTrackTxStatus(e){try{const t=await this.httpClient.getTransferStatus(e.txId);if(e.status!==t.status){let s;switch(t.status){case"success":s="confirmed";break;case"failed":s="failed";break;default:s="pending"}return this.emitSyntheticEvent({type:"txChanged",txId:e.txId,status:s}),e.status=t.status,this.pollingManager.persist(),"pending"!==t.status&&this.pollingManager.add(m.EVENT_TYPES.UPDATE_ACCOUNT,{txId:e.txId}),"success"===t.status||"failed"===t.status}}catch(t){if(t instanceof Error&&(t.message.includes("401")&&this.destroy(),t.message.includes("404")))return this.emitSyntheticEvent({type:"txChanged",txId:e.txId,status:"failed"}),!0}return!1}async handleRestoreSession(e){try{const e=await this.httpClient.getBalance();if(e&&e.holdings){const t=[{partyId:e.party_id,holdings:Object.entries(e.holdings).map(([e,t])=>({instrumentId:e,balance:Number(t.balance),balanceUsd:Number(t.balance_usd)}))}];this.session.setAccounts(t),this.session.save(),this.session.setConnected(!0),this.emitSyntheticEvent({type:"connected"});const s=this.session.getExpireAt();return s&&this.scheduleDisconnect(s),!0}}catch(e){e instanceof Error&&e.message.includes("401")&&this.destroy()}return!1}get WALLET_EMBEDDED(){return`${this.origin}/embedded/`}async init(e){var t;if(void 0!==this.popup&&(null==(t=this.popup)||!t.closed))return;if(this.initDeferred||(this.initDeferred=f()),this.listening||this.attachListener(),this.popup&&!this.popup.closed)return this.popup.focus(),null==this.handshakeTimer&&this.startHandshakeLoop(),this.initDeferred.promise;const s=new URL(null!=e?e:"",this.WALLET_EMBEDDED);if(this.popup=window.open(s,this.WINDOW_NAME,`width=${this.WINDOW_WIDTH},height=${this.WINDOW_HEIGHT}`),!this.popup){const e=new Error("Failed to open popup window");Object.assign(e,{code:"POPUP_BLOCKED",message:"browser blocked the popup window"}),this.rejectInit(e)}return this.startHandshakeLoop(),this.initDeferred.promise}emitSyntheticEvent(e){for(const t of this.eventHandlers)try{t({kind:"event",event:e})}catch(e){}}scheduleDisconnect(e){if(!e)return;const t=e-Date.now();if(t>0){const e=setTimeout(()=>{this.destroy("authToken expired")},t);this.session.setDisconnectTimeoutId(e)}else this.destroy("authToken expired")}destroy(e="destroyed"){try{this.emitSyntheticEvent({type:"disconnected",reason:e}),this.detachListener(),this.clearHandshakeLoop(),this.initDeferred&&(this.initDeferred.reject(new Error("Transport destroyed")),this.initDeferred=void 0);for(const[,e]of this.pending)e.reject(new Error("Transport destroyed"));this.pending.clear(),this.popup&&!this.popup.closed&&this.popup.close(),this.popup=void 0,this.walletReady=!1,this.session.clear(),this.pollingManager.clear()}catch(e){}}async request(e,t,s){var n,i,r,a,o,h,d,c,l,u,p,m,g,v,T,I;const w=crypto.randomUUID(),E=f();this.pending.set(w,E);try{if("connect"===e){if(this.session.getBearerToken())return this.handleResponse({kind:"response",id:w,result:null}),E.promise;this.session.getBearerToken()||(this.walletReady=!1),await this.init()}if("send"===e&&(this.walletReady=!1,await this.init("confirmTransaction")),"signAndExecute"===e&&(this.walletReady=!1,await this.init("signAndExecute")),"status"===e)return this.handleResponse({kind:"response",id:w,result:{connected:this.session.getConnected(),walletVersion:void 0}}),E.promise;if(s&&(null==(n=this.popup)||n.focus()),"getInstruments"===e){const e=this.session.getInstruments();return this.handleResponse({kind:"response",id:w,result:{instruments:e}}),E.promise}if("getAccounts"===e){await this.handleAccountUpdate();const e=this.session.getAccounts();return this.handleResponse({kind:"response",id:w,result:{accounts:e}}),E.promise}if("checkTxStatusById"===e){const e=t,s=await this.getTransferStatusById(null==e?void 0:e.txId);if(s){const e={status:s.status,transfer:{senderPartyId:null!=(r=null==(i=s.transfer)?void 0:i.party_id)?r:"",receiverPartyId:null!=(o=null==(a=s.transfer)?void 0:a.party_id2)?o:"",amount:Number(null!=(d=null==(h=s.transfer)?void 0:h.amount)?d:"0"),networkFees:Number(null!=(l=null==(c=s.transfer)?void 0:c.network_fees)?l:"0"),instrumentId:null!=(p=null==(u=s.transfer)?void 0:u.instrument_id)?p:"",txId:null!=(g=null==(m=s.transfer)?void 0:m.command_id)?g:"",created_at:null!=(T=null==(v=s.transfer)?void 0:v.created_at)?T:"",memo:null==(I=s.transfer)?void 0:I.reason}};this.handleResponse({kind:"response",id:w,result:e})}else this.handleResponse({kind:"response",id:w,error:{code:"FAILED_TO_FETCH_TRANSFER_STATUS",message:"Failed to fetch transfer status"}});return E.promise}if("disconnect"===e)return this.handleResponse({kind:"response",id:w,result:null}),E.promise;const f={kind:"request",id:w,method:e,params:t,sessionId:this.sessionId};this.post(f)}catch(e){this.pending.delete(w),E.reject(e)}return E.promise}onEvent(e){return this.eventHandlers.add(e),()=>{this.eventHandlers.delete(e)}}attachListener(){this.listening||(window.addEventListener("message",this.onWindowMessage),this.listening=!0)}detachListener(){this.listening&&(window.removeEventListener("message",this.onWindowMessage),this.listening=!1)}post(e){try{if(!this.popup||this.popup.closed)return;this.popup.postMessage(e,this.origin)}catch(e){}}onWindowMessage(e){if(e.origin!==this.origin)return;const t=e.data;if(t&&"object"==typeof t){if("event"===t.kind){for(const e of this.eventHandlers)"txInitiated"===t.event.type&&this.pollingManager.add(m.EVENT_TYPES.TRACK_TX_STATUS,{txId:t.event.txId,status:"initiated"}),e(t);return}if("internal_event"===t.kind)return void this.pollingManager.add(t.event.type,{wop:"wopwop"});if("auth-flow"===t.kind&&(this.session.setBearerToken(t.token,t.expireAt),this.session.setAccounts(t.accounts),this.session.setInstruments(t.instruments),this.session.save(),this.scheduleDisconnect(t.expireAt)),"handshake-ack"===t.kind&&t.ok)return void this.handleHandshakeAck();"response"===t.kind&&this.handleResponse(t)}}handleHandshakeAck(){this.walletReady=!0,this.clearHandshakeLoop(),this.initDeferred&&(this.initDeferred.resolve(),this.initDeferred=void 0)}handleResponse(e){const t=this.pending.get(e.id);if(t)if(this.pending.delete(e.id),e.error){const s=new Error(e.error.message||"Unknown Error");Object.assign(s,{code:e.error.code,data:e.error.data}),t.reject(s)}else t.resolve(e.result)}startHandshakeLoop(){this.handshakeDeadline=Date.now()+55e3;const e=()=>{if(!this.walletReady)return!this.popup||this.popup.closed?(this.clearHandshakeLoop(),void this.rejectInit(new Error("Popup closed before handshake"))):this.handshakeDeadline&&Date.now()>this.handshakeDeadline?(this.clearHandshakeLoop(),void this.rejectInit(new Error("Handshake timed out"))):void this.post({kind:"handshake",sdkVersion:"0.0.0",sessionId:this.sessionId,dapp:{name:this.appName,url:this.appUrl}});this.clearHandshakeLoop()};e(),this.handshakeTimer=window.setInterval(e,300)}clearHandshakeLoop(){null!=this.handshakeTimer&&(clearInterval(this.handshakeTimer),this.handshakeTimer=void 0),this.handshakeDeadline=void 0}rejectInit(e){this.initDeferred&&(Object.assign(e,{code:"INITIALIZATION_FAILED",message:e.message}),this.initDeferred.reject(e),this.initDeferred=void 0)}startPopupClosedWatcher(){const e=this.popup;if(!e)return;const t=window.setInterval(()=>{(!e||e.closed)&&(clearInterval(t),this.destroy())},300);this.closeWatcherTimer=t}}var E=Object.defineProperty,y=(e,t,s)=>((e,t,s)=>t in e?E(e,t,{enumerable:!0,configurable:!0,writable:!0,value:s}):e[t]=s)(e,"symbol"!=typeof t?t+"":t,s);class k{constructor(t){var s,n,i;y(this,"transport"),y(this,"listeners",{});const r=null!=(s=t.dappName)?s:document.title||"Unknown dApp",a=null!=(n=t.dappUrl)?n:location.origin,o=null!=(i=t.network)?i:"mainnet";let h;if("devnet"!==o)throw new Error("Only devnet network is supported right now");if("devnet"!==o)throw new Error("Unsupported network: "+o);h=e,this.transport=new w(r,a,h),this.transport.onEvent(e=>{"event"===e.kind&&this.emit(e.event.type,e.event)})}async connect(){await this.transport.request("connect",void 0,!0)}async disconnect(){try{await this.transport.request("disconnect"),this.transport.destroy()}catch(e){}}status(){return this.transport.request("status")}getInstruments(){return this.transport.request("getInstruments")}getAccounts(e){return this.transport.request("getAccounts",{instrumentId:e})}send(e){return this.transport.request("send",e,!0)}signAndExecute(e){return this.transport.request("signAndExecute",e,!0)}signAndExecutePreparedTransfer(e){return this.transport.request("signAndExecutePreparedTransfer",e,!0)}acknowledge(e){return this.transport.request("acknowledge",e,!0)}checkTxStatusById(e){return this.transport.request("checkTxStatusById",e)}on(e,t){return this.listeners[e]||(this.listeners[e]=new Set),this.listeners[e].add(t),()=>this.listeners[e].delete(t)}emit(e,t){var s;for(const n of null!=(s=this.listeners[e])?s:[])n(t)}}const S={uuid:"c8-wallet-connect",name:"C8 Wallet",icon:"",rdns:"tech.cantor8.wallet"},A="c8#provider_discovery";function b(e){const t={info:S,provider:e()};window.dispatchEvent(new CustomEvent(A,{detail:t}))}function C(e){const t=t=>{const s=t;s.detail&&e(s.detail.info,s.detail.provider)};return window.addEventListener(A,t),()=>window.removeEventListener(A,t)}export{k as C8WalletProvider,v as HttpClient,s as LocalStorageHelper,b as announceC8Provider,C as onC8ProviderDiscovered};

package/dist/provider.d.ts

@@ -0,0 +1,40 @@
+import { C8EventByType, C8EventType, Listener } from "./types";
+export declare class C8WalletProvider {
+    private transport;
+    private listeners;
+    constructor(opts: {
+        dappName: string;
+        dappUrl?: string;
+        network?: "devnet" | "mainnet" | "local";
+    });
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    status(): Promise<{
+        connected: boolean;
+        walletVersion?: string;
+    }>;
+    getInstruments(): Promise<import("./types").InstrumentListPayload>;
+    getAccounts(instrumentId?: string): Promise<import("./types").AccountListPayload>;
+    send(input: {
+        senderPartyId: string;
+        instrumentId: string;
+        amount: number;
+        receiverPartyId: string;
+        memo?: string;
+        metadata?: Record<string, string>;
+    }): Promise<import("./types").SubmitTransferResultPayload>;
+    signAndExecute(input: {
+        note: string;
+        partyId: string;
+        commandId: string;
+        commandsJson: string;
+        disclosedContracts: string[];
+    }): Promise<void>;
+    private signAndExecutePreparedTransfer;
+    private acknowledge;
+    checkTxStatusById(input: {
+        txId: string;
+    }): Promise<import("./types").TransferStatusResponsePayload>;
+    on<T extends C8EventType>(event: T, cb: Listener<C8EventByType<T>>): () => boolean;
+    private emit;
+}

package/dist/session.d.ts

@@ -0,0 +1,33 @@
+import { AccountInfoPayload, InstrumentInfoPayload } from "./types";
+declare class Session {
+    private static instance;
+    static readonly SESSION_KEY = "c8-session";
+    private appName;
+    private accounts;
+    private instruments;
+    private partyIds;
+    private authToken;
+    private isConnected;
+    private expireAt;
+    private disconnectTimeoutId;
+    private constructor();
+    static getInstance(): Session;
+    setAppName(appName: string): void;
+    getAppName(): string | undefined;
+    setInstruments(instruments: InstrumentInfoPayload[]): void;
+    getInstruments(): InstrumentInfoPayload[];
+    setAccounts(accounts: AccountInfoPayload[]): void;
+    getAccounts(): AccountInfoPayload[];
+    setBearerToken(token: string | null, expireAt: number | null): void;
+    getExpireAt(): number | null;
+    setDisconnectTimeoutId(id: any): void;
+    getDisconnectTimeoutId(): any;
+    getBearerToken(): string | null;
+    clear(): void;
+    save(): void;
+    setConnected(isConnected: boolean): void;
+    getConnected(): boolean;
+    hasStoredSession(): boolean;
+    private load;
+}
+export default Session;

package/dist/transport.d.ts

@@ -0,0 +1,6 @@
+export type { Transport } from "./transports/Transport";
+export { WindowTransport } from "./transports/WindowTransport";
+export { ThinTransport } from "./transports/ThinTransport";
+export { IFrameTransport } from "./transports/IFrameTransport";
+export { WebViewTransport } from "./transports/WebViewTransport";
+export { WALLET_EMBED_URL, WALLET_ORIGIN_MAINNET, WALLET_ORIGIN_DEVNET } from "./transports/constants";

package/dist/transports/IFrameTransport.d.ts

@@ -0,0 +1,46 @@
+import { InboundMessage, WalletMethod } from "../types";
+import type { Transport } from "./Transport";
+/**
+ * IFrameTransport embeds the wallet into the current page via an <iframe>
+ * and communicates with it using window.postMessage. This avoids popups
+ * and provides a persistent, same-tab experience.
+ */
+export declare class IFrameTransport implements Transport {
+    private readonly dappName;
+    private readonly dappUrl;
+    private readonly origin;
+    /**
+     * Optional target where the iframe should be appended. If a function is provided
+     * it will be called at init-time to resolve the element. Defaults to document.body.
+     */
+    private readonly appendTarget?;
+    private iframe?;
+    private readonly sessionId;
+    private listening;
+    private walletReady;
+    private readonly pending;
+    private readonly eventHandlers;
+    private handshakeTimer?;
+    private handshakeDeadline?;
+    private initDeferred?;
+    constructor(dappName: string, dappUrl: string, origin?: string, 
+    /**
+     * Optional target where the iframe should be appended. If a function is provided
+     * it will be called at init-time to resolve the element. Defaults to document.body.
+     */
+    appendTarget?: (Element | (() => Element | null)) | undefined);
+    private get WALLET_EMBEDDED();
+    init(): Promise<void>;
+    destroy(): void;
+    request<M extends WalletMethod, T = unknown>(method: M, params?: unknown, _forceShow?: boolean): Promise<T>;
+    onEvent(cb: (msg: InboundMessage) => void): () => void;
+    private attachListener;
+    private detachListener;
+    private post;
+    private onWindowMessage;
+    private handleHandshakeAck;
+    private handleResponse;
+    private startHandshakeLoop;
+    private clearHandshakeLoop;
+    private rejectInit;
+}

package/dist/transports/ThinTransport.d.ts

@@ -0,0 +1,36 @@
+import { InboundMessage, WalletMethod } from "../types";
+import type { Transport } from "./Transport";
+/**
+ * ThinTransport is used when both dApp and Wallet run within the same page context
+ * (e.g., wallet is embedded in an iframe and exposes the SDK). Communication is
+ * direct via postMessage with a provided target window and origin. No popup or
+ * window management is performed here.
+ */
+export declare class ThinTransport implements Transport {
+    private readonly appName;
+    private readonly appUrl;
+    private readonly targetOrigin;
+    private readonly targetWindow;
+    private readonly sessionId;
+    private listening;
+    private walletReady;
+    private readonly pending;
+    private readonly eventHandlers;
+    private handshakeTimer?;
+    private handshakeDeadline?;
+    private initDeferred?;
+    constructor(appName: string, appUrl: string, targetOrigin: string, targetWindow: Window | null | undefined);
+    init(): Promise<void>;
+    destroy(): void;
+    request<M extends WalletMethod, T = unknown>(method: M, params?: unknown, _forceShow?: boolean): Promise<T>;
+    onEvent(cb: (msg: InboundMessage) => void): () => void;
+    private attachListener;
+    private detachListener;
+    private post;
+    private onWindowMessage;
+    private handleHandshakeAck;
+    private handleResponse;
+    private startHandshakeLoop;
+    private clearHandshakeLoop;
+    private rejectInit;
+}

package/dist/transports/Transport.d.ts

@@ -0,0 +1,7 @@
+import type { InboundMessage, WalletMethod, WalletRequestPayloadMap, WalletResponsePayloadMap } from "../types";
+export interface Transport {
+    init(): Promise<void>;
+    destroy(): void;
+    request<M extends WalletMethod>(method: M, params?: WalletRequestPayloadMap[M], forceShow?: boolean): Promise<WalletResponsePayloadMap[M]>;
+    onEvent(cb: (msg: InboundMessage) => void): () => void;
+}

package/dist/transports/WebViewTransport.d.ts

@@ -0,0 +1,39 @@
+import type { InboundMessage, WalletMethod } from "../types";
+import type { Transport } from "./Transport";
+/**
+ * WebViewTransport (WebView-only)
+ * Runs INSIDE the WebView page (dApp side) and talks to the native app via:
+ * - web -> native: window.ReactNativeWebView.postMessage(string)
+ * - native -> web: "message" events (window + document), payload is usually string
+ *
+ * Assumptions:
+ * - We do NOT support iframe/popup/window.opener here (webview only).
+ * - We do NOT use WKWebView messageHandlers / AndroidInterface hooks here.
+ */
+export declare class WebViewTransport implements Transport {
+    private readonly dappName;
+    private readonly dappUrl;
+    private readonly sessionId;
+    private listening;
+    private walletReady;
+    private readonly pending;
+    private readonly eventHandlers;
+    private handshakeTimer?;
+    private handshakeDeadline?;
+    private initDeferred?;
+    constructor(dappName: string, dappUrl: string);
+    init(): Promise<void>;
+    destroy(): void;
+    request<M extends WalletMethod, T = unknown>(method: M, params?: unknown): Promise<T>;
+    onEvent(cb: (msg: InboundMessage) => void): () => void;
+    private attachListener;
+    private detachListener;
+    private onMessageEvent;
+    private processInboundMessage;
+    private handleHandshakeAck;
+    private handleResponse;
+    private postToNative;
+    private startHandshakeLoop;
+    private clearHandshakeLoop;
+    private rejectInit;
+}

package/dist/transports/WindowTransport.d.ts

@@ -0,0 +1,46 @@
+import { InboundMessage, WalletMethod, WalletRequestPayload } from "../types";
+import type { Transport } from "./Transport";
+export declare class WindowTransport implements Transport {
+    private readonly appName;
+    private readonly appUrl;
+    private readonly origin;
+    private WINDOW_NAME;
+    private WINDOW_WIDTH;
+    private WINDOW_HEIGHT;
+    private popup?;
+    private readonly sessionId;
+    private listening;
+    private walletReady;
+    private readonly pending;
+    private readonly eventHandlers;
+    private handshakeTimer?;
+    private handshakeDeadline?;
+    private closeWatcherTimer?;
+    private pollingManager;
+    private session;
+    private initDeferred?;
+    private httpClient;
+    constructor(appName: string, appUrl: string, origin?: string);
+    private checkRestoreSession;
+    private handleAccountUpdate;
+    private getTransferStatusById;
+    private handleTrackTxStatus;
+    private handleRestoreSession;
+    private get WALLET_EMBEDDED();
+    init(path?: string): Promise<void>;
+    private emitSyntheticEvent;
+    private scheduleDisconnect;
+    destroy(reason?: string): void;
+    request<M extends WalletMethod, T = unknown>(method: M, params?: WalletRequestPayload<M>, forceShow?: boolean): Promise<T>;
+    onEvent(cb: (msg: InboundMessage) => void): () => void;
+    private attachListener;
+    private detachListener;
+    private post;
+    private onWindowMessage;
+    private handleHandshakeAck;
+    private handleResponse;
+    private startHandshakeLoop;
+    private clearHandshakeLoop;
+    private rejectInit;
+    private startPopupClosedWatcher;
+}

package/dist/transports/constants.d.ts

@@ -0,0 +1,7 @@
+export declare const WALLET_ORIGIN_LOCAL = "http://localhost:8081";
+export declare const WALLET_ORIGIN_DEVNET = "https://wallet.dev.digik.cantor8.tech";
+export declare const WALLET_API_DEVNET = "https://wallet-backend.dev.digik.cantor8.tech";
+export declare const WALLET_ORIGIN_MAINNET = "https://wallet.cantor8.tech";
+export declare const WALLET_API_MAINNET = "https://wallet-backend.main.cantor8.tech";
+export declare const WALLET_ORIGIN_TEST_MAINNET = "https://wallet.main.digik.cantor8.tech";
+export declare const WALLET_EMBED_URL = "/embedded";

package/dist/types.d.ts

@@ -0,0 +1,212 @@
+export type Json = null | boolean | number | string | Json[] | {
+    [k: string]: Json;
+};
+export type RpcError = {
+    code: string;
+    message: string;
+    data?: Json;
+};
+export type Listener<T extends C8Event> = (event: T) => void;
+export type C8Event = {
+    type: "connected";
+    meta?: Json;
+} | {
+    type: "disconnected";
+    reason?: string;
+    meta?: Json;
+} | {
+    type: "txInitiated";
+    txId?: string;
+    meta?: Json;
+} | {
+    type: "txChanged";
+    txId: string;
+    status: "pending" | "confirmed" | "failed" | string;
+    meta?: Json;
+} | {
+    type: "themeChanged";
+    theme: "dark" | "light";
+    meta?: Json;
+} | {
+    type: "operationCanceled";
+    reason: string;
+    meta?: Json;
+} | {
+    type: "accountChanged";
+    accounts: AccountInfoPayload[];
+    meta?: Json;
+};
+export type C8EventType = C8Event["type"];
+export type C8EventByType<T extends C8EventType> = Extract<C8Event, {
+    type: T;
+}>;
+export type OutboundMessage<M extends WalletMethod = WalletMethod> = {
+    kind: "handshake";
+    sdkVersion: string;
+    sessionId: string;
+    dapp: {
+        name: string;
+        url: string;
+    };
+} | {
+    kind: "request";
+    id: string;
+    method: M;
+    params: WalletRequestPayload<M>;
+    sessionId: string;
+};
+export type InboundMessage = {
+    kind: "handshake-ack";
+    ok: true;
+    walletVersion: string;
+} | {
+    kind: "response";
+    id: string;
+    result?: Json;
+    error?: RpcError;
+} | {
+    kind: "event";
+    event: C8Event;
+} | {
+    kind: "auth-flow";
+    token: string;
+    expireAt: number;
+    accounts: AccountInfoPayload[];
+    instruments: InstrumentInfoPayload[];
+} | {
+    kind: "internal_event";
+    event: {
+        type: string;
+        payload: any;
+    };
+};
+export type WalletMethod = "connect" | "disconnect" | "status" | "getInstruments" | "getAccounts" | "send" | "signAndExecute" | "signAndExecutePreparedTransfer" | "acknowledge" | "checkTxStatusById";
+export interface WalletRequestPayloadMap {
+    connect: undefined;
+    disconnect: undefined;
+    status: undefined;
+    getInstruments: undefined;
+    getAccounts: {
+        instrumentId?: string;
+    };
+    send: {
+        senderPartyId: string;
+        instrumentId: string;
+        amount: number;
+        receiverPartyId: string;
+        memo?: string;
+        metadata?: Record<string, string>;
+    };
+    signAndExecute: {
+        note: string;
+        partyId: string;
+        commandId: string;
+        commandsJson: string;
+        disclosedContracts: string[];
+    };
+    signAndExecutePreparedTransfer: {
+        partyId: string;
+        commandId: string;
+        preparedTxB64: string;
+        hashB64: string;
+        hashingSchemeVersion: string;
+        fees?: TransferFee[];
+        totalFee?: number;
+    };
+    acknowledge: {
+        partyId: string;
+        txId: string;
+    };
+    checkTxStatusById: {
+        txId: string;
+    };
+}
+export type WalletRequestPayload<M extends WalletMethod> = WalletRequestPayloadMap[M];
+export interface TransferTransactionPayload {
+    senderPartyId: string;
+    receiverPartyId: string;
+    amount: number;
+    networkFees: number;
+    instrumentId: string;
+    txId: string;
+    created_at?: string | null;
+    memo?: string | null;
+}
+export interface TransferStatusResponsePayload {
+    status: string;
+    transfer: TransferTransactionPayload | null;
+}
+export interface SubmitTransferResultPayload {
+    txId: string;
+}
+export interface AppConfigPayload {
+    min_supported_version: string;
+    latest_version: string;
+    update_url_ios?: string | null;
+    update_url_android?: string | null;
+    signups_guarded?: boolean;
+}
+export interface AccountInfoHolding {
+    instrumentId: string;
+    balance: number;
+    balanceUsd: number;
+}
+export interface AccountInfoPayload {
+    accountName?: string;
+    partyId: string;
+    holdings: AccountInfoHolding[];
+}
+export interface AccountListPayload {
+    accounts: AccountInfoPayload[];
+}
+export interface TransferHistoryResponsePayload {
+    transfers: TransferTransactionPayload[];
+}
+export interface TokenOfferPayload {
+    contractId: string;
+    senderPartyId: string;
+    instrumentId: string;
+    amount: number;
+}
+export interface TransferFee {
+    amount: number;
+    receiverPartyId: string;
+    description: string;
+    instrumentId: string | null;
+}
+export interface TokenOffersPayload {
+    offers: TokenOfferPayload[];
+}
+export interface InstrumentInfoPayload {
+    instrumentId: string;
+    name: string;
+    symbol: string;
+}
+export interface InstrumentListPayload {
+    instruments: InstrumentInfoPayload[];
+}
+export interface WalletResponsePayloadMap {
+    connect: void;
+    disconnect: void;
+    status: {
+        connected: boolean;
+        walletVersion?: string;
+    };
+    getInstruments: InstrumentListPayload;
+    getAccounts: AccountListPayload;
+    send: SubmitTransferResultPayload;
+    signAndExecute: void;
+    signAndExecutePreparedTransfer: SubmitTransferResultPayload;
+    acknowledge: {
+        success: boolean;
+    };
+    checkTxStatusById: TransferStatusResponsePayload;
+}
+export type WalletResponsePayload<M extends WalletMethod> = WalletResponsePayloadMap[M];
+export type PollingHandler = (params: any) => Promise<boolean>;
+export interface PollingEvent {
+    key: string;
+    type: string;
+    params: any;
+    createdAt?: number;
+}

package/dist/utils/HttpClient.d.ts

@@ -0,0 +1,8 @@
+import { PartyHoldingsApiResponse, TransferTransactionApiResponse } from "./HttpClient.types";
+export declare class HttpClient {
+    private readonly baseUrl;
+    constructor(baseUrl: string);
+    private request;
+    getBalance(): Promise<PartyHoldingsApiResponse>;
+    getTransferStatus(txId: string): Promise<TransferTransactionApiResponse>;
+}

package/dist/utils/HttpClient.types.d.ts

@@ -0,0 +1,31 @@
+export interface TransferTransactionApiResponse {
+    status: string;
+    transfer: TransferTransactionApiPayload;
+}
+export interface TransferTransactionApiPayload {
+    party_id: string;
+    party_id2: string;
+    direction: "OUT" | "IN";
+    amount: string;
+    network_fees: string;
+    instrument_id: string;
+    reason: string | null;
+    execute_before: string | null;
+    final_update_id: string | null;
+    update_id: string;
+    command_id: string;
+    ledger_offset: number;
+    record_time: string;
+    created_at: string;
+    metadata: Record<string, string>;
+    status: string | null;
+}
+export interface HoldingDetails {
+    instrument_admin_id: string;
+    balance: string;
+    balance_usd: string;
+}
+export interface PartyHoldingsApiResponse {
+    party_id: string;
+    holdings: Record<string, HoldingDetails>;
+}

package/dist/utils/PollingManager.d.ts

@@ -0,0 +1,27 @@
+import { PollingEvent, PollingHandler } from "../types";
+export declare class PollingManager {
+    private pollingInterval;
+    static readonly EVENT_TYPES: {
+        readonly RESTORE_SESSION: "RESTORE_SESSION";
+        readonly TRACK_TX_STATUS: "TRACK_TX_STATUS";
+        readonly UPDATE_ACCOUNT: "UPDATE_ACCOUNT";
+    };
+    static type: typeof PollingManager.EVENT_TYPES[keyof typeof PollingManager.EVENT_TYPES];
+    private static instance;
+    private static readonly STORAGE_KEY;
+    private static readonly POLLING_TIMEOUT;
+    private events;
+    private intervals;
+    private handlerRegistry;
+    private constructor();
+    static getInstance(pollingInterval?: number): PollingManager;
+    registerHandler(type: string, handler: PollingHandler): void;
+    add(type: string, params: any): void;
+    remove(key: string): void;
+    private startPolling;
+    private stopPolling;
+    persist(): void;
+    restore(): void;
+    clear(): void;
+    getEvents(): PollingEvent[];
+}

package/dist/utils/instruments.d.ts

@@ -0,0 +1,2 @@
+export declare const getInstrumentLabel: (instrumentId: string | undefined) => string;
+export declare const getInstrumentSymbol: (instrumentId: string | undefined) => string;

package/dist/utils/storage.d.ts

@@ -0,0 +1,19 @@
+export declare class LocalStorageHelper {
+    /**
+     * Get item from localStorage
+     * @param key
+     * @returns {T | null}
+     */
+    static getItem<T>(key: string): T | null;
+    /**
+     * Set item in localStorage
+     * @param key
+     * @param value
+     */
+    static setItem<T>(key: string, value: T): void;
+    /**
+     * Remove item from localStorage
+     * @param key
+     */
+    static removeItem(key: string): void;
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@cantor8/wallet-connect-sdk",
+  "version": "0.3.0-alpha.1",
+  "description": "C8 Wallet Connect SDK for dApp developers: postMessage API to interact with C8 Wallet.",
+  "author": "C8 / Cantor8",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.esm.js",
+  "types": "./dist/index.d.ts",
+  "browser": "./dist/index.esm.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.esm.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.cjs",
+    "dist/**/*.d.ts",
+    "README.md"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "npm run clean && rollup -c && tsc --emitDeclarationOnly",
+    "typecheck": "tsc --noEmit",
+    "prepare": "npm run build",
+    "pack": "npm run build && npm pack"
+  },
+  "keywords": [
+    "wallet",
+    "connect",
+    "canton",
+    "c8",
+    "dapp",
+    "sdk"
+  ],
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^29.0.2",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-terser": "^1.0.0",
+    "rollup": "^4.60.2",
+    "rollup-plugin-esbuild": "^6.1.0",
+    "typescript": "^6.0.3"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  }
+}