@partylayer/adapter-cantor8 0.2.20 → 0.3.0

package/dist/index.d.mts

@@ -1,97 +1,74 @@
 import * as _partylayer_core from '@partylayer/core';
-import { ConnectRequest, ConnectResponse, SignRequest, SignResponse, JobStatus, WalletAdapter, CapabilityKey, AdapterDetectResult, AdapterContext, AdapterConnectResult, SignMessageParams, SignTransactionParams } from '@partylayer/core';
+import { WalletAdapter, CapabilityKey, AdapterDetectResult, AdapterContext, AdapterConnectResult, Session, SignMessageParams, SignedMessage, SubmitTransactionParams, TxReceipt, AdapterEventName } from '@partylayer/core';
 
 /**
- * Cantor8 Vendor Integration Module
- *
- * This module abstracts vendor-specific endpoints and can be swapped
- * without breaking the adapter API.
- *
- * References:
- * - Cantor8 ecosystem: https://www.canton.network/ecosystem/cantor8
- * - Cantor8 site: https://cantor8.tech/about
+ * The shape `submitTransaction` expects in `params.signedTx`: the Cantor8 SDK's
+ * `signAndExecute` input. The caller owns this shape (passthrough).
  */
-
-/**
- * Vendor configuration
- */
-interface Cantor8VendorConfig {
-    /** Deep link scheme (e.g., "cantor8") */
-    deepLinkScheme?: string;
-    /** Universal link base URL (e.g., "https://app.cantor8.tech") */
-    universalLinkBase?: string;
-    /** Connect endpoint path */
-    connectEndpoint?: string;
-    /** Sign endpoint path */
-    signEndpoint?: string;
-    /** Job status endpoint path (for async approvals) */
-    statusEndpoint?: string;
-    /** Redirect URI for callbacks */
-    redirectUri?: string;
+interface Cantor8SubmitPayload {
+    note?: string;
+    partyId: string;
+    commandId: string;
+    commandsJson: string;
+    disclosedContracts?: string;
 }
 /**
- * Vendor module interface
- *
- * Implementations can be swapped without changing adapter code.
+ * Cantor8 adapter configuration.
  */
-interface Cantor8VendorModule {
-    /**
-     * Create connect URL
-     */
-    createConnectUrl(request: ConnectRequest, config: Cantor8VendorConfig): string;
-    /**
-     * Parse connect callback
-     */
-    parseConnectCallback(callbackData: unknown, expectedState: string): ConnectResponse;
-    /**
-     * Create sign URL
-     */
-    createSignUrl(request: SignRequest, config: Cantor8VendorConfig): string;
-    /**
-     * Parse sign callback
-     */
-    parseSignCallback(callbackData: unknown, expectedState: string): SignResponse;
+interface Cantor8AdapterConfig {
+    /** dApp URL passed to the Cantor8 SDK popup handshake. Defaults to `ctx.origin`. */
+    dappUrl?: string;
     /**
-     * Poll job status (optional, for async approvals)
+     * How long `detectInstalled()` waits for the wallet's `c8#provider_discovery`
+     * announcement before reporting not-detected. Default 300ms.
      */
-    pollJobStatus?(jobId: string, statusUrl: string, timeoutMs: number): Promise<JobStatus>;
-}
-
-/**
- * Cantor8 adapter configuration
- */
-interface Cantor8AdapterConfig {
-    /** Vendor module (defaults to stub) */
-    vendorModule?: Cantor8VendorModule;
-    /** Vendor configuration */
-    vendorConfig?: Cantor8VendorConfig;
-    /** Use mock transport in development */
-    useMockTransport?: boolean;
+    detectTimeoutMs?: number;
 }
 /**
- * Cantor8 Wallet Adapter
+ * Cantor8 Wallet Adapter.
  */
 declare class Cantor8Adapter implements WalletAdapter {
     readonly walletId: _partylayer_core.WalletId;
     readonly name = "Cantor8";
-    private vendorModule;
-    private vendorConfig;
-    private transport;
+    private readonly config;
+    private provider;
     constructor(config?: Cantor8AdapterConfig);
     getCapabilities(): CapabilityKey[];
+    /** The SDK supports devnet and mainnet only; anything else fails at connect. */
+    private mapNetwork;
     detectInstalled(): Promise<AdapterDetectResult>;
-    connect(ctx: AdapterContext, opts?: {
+    connect(ctx: AdapterContext, _opts?: {
         timeoutMs?: number;
-        partyId?: _partylayer_core.PartyId;
     }): Promise<AdapterConnectResult>;
-    disconnect(_ctx: AdapterContext, _session: _partylayer_core.Session): Promise<void>;
-    restore(_ctx: AdapterContext, persisted: _partylayer_core.PersistedSession): Promise<_partylayer_core.Session | null>;
-    signMessage(ctx: AdapterContext, session: _partylayer_core.Session, params: SignMessageParams): Promise<_partylayer_core.SignedMessage>;
-    signTransaction(ctx: AdapterContext, session: _partylayer_core.Session, params: SignTransactionParams): Promise<_partylayer_core.SignedTransaction>;
+    disconnect(_ctx: AdapterContext, _session: Session): Promise<void>;
+    /**
+     * Cantor8 has NO arbitrary-message signing. Per the honesty rule: do not
+     * simulate it, do not route it through `signAndExecute` (which is for
+     * transactions), and do not silently succeed. Fail with the typed capability
+     * error. `signMessage` is also absent from `getCapabilities()`, so the SDK's
+     * capability guard blocks it first; this is the belt-and-suspenders backstop.
+     */
+    signMessage(_ctx: AdapterContext, _session: Session, _params: SignMessageParams): Promise<SignedMessage>;
+    /**
+     * Submit a transaction through the SDK's `signAndExecute` (sign + execute
+     * fused; the wallet has no separate sign step). `params.signedTx` is passed
+     * through: the caller owns its shape, which must be a {@link Cantor8SubmitPayload}.
+     *
+     * The SDK's `signAndExecute` resolves with no id; Cantor8 delivers the
+     * on-ledger txId and status asynchronously via the `txChanged` event (surfaced
+     * through `on('txStatus')`). The receipt is therefore keyed on the
+     * caller-supplied `commandId`; the confirmed ledger id arrives on the event
+     * stream. A live run against the real wallet is required to confirm
+     * end-to-end execution.
+     */
+    submitTransaction(_ctx: AdapterContext, _session: Session, params: SubmitTransactionParams): Promise<TxReceipt>;
     /**
-     * Generate random state nonce
+     * Forward the wallet's transaction-status stream. Cantor8 emits `txChanged`
+     * ({ txId, status }); PartyLayer surfaces this as the `events` capability under
+     * the `txStatus` event. Any other event name is a no-op. Returns an
+     * unsubscribe function.
      */
-    private generateState;
+    on(event: AdapterEventName, handler: (payload: unknown) => void): () => void;
 }
 
-export { Cantor8Adapter, type Cantor8AdapterConfig };
+export { Cantor8Adapter, type Cantor8AdapterConfig, type Cantor8SubmitPayload };

package/dist/index.d.ts

@@ -1,97 +1,74 @@
 import * as _partylayer_core from '@partylayer/core';
-import { ConnectRequest, ConnectResponse, SignRequest, SignResponse, JobStatus, WalletAdapter, CapabilityKey, AdapterDetectResult, AdapterContext, AdapterConnectResult, SignMessageParams, SignTransactionParams } from '@partylayer/core';
+import { WalletAdapter, CapabilityKey, AdapterDetectResult, AdapterContext, AdapterConnectResult, Session, SignMessageParams, SignedMessage, SubmitTransactionParams, TxReceipt, AdapterEventName } from '@partylayer/core';
 
 /**
- * Cantor8 Vendor Integration Module
- *
- * This module abstracts vendor-specific endpoints and can be swapped
- * without breaking the adapter API.
- *
- * References:
- * - Cantor8 ecosystem: https://www.canton.network/ecosystem/cantor8
- * - Cantor8 site: https://cantor8.tech/about
+ * The shape `submitTransaction` expects in `params.signedTx`: the Cantor8 SDK's
+ * `signAndExecute` input. The caller owns this shape (passthrough).
  */
-
-/**
- * Vendor configuration
- */
-interface Cantor8VendorConfig {
-    /** Deep link scheme (e.g., "cantor8") */
-    deepLinkScheme?: string;
-    /** Universal link base URL (e.g., "https://app.cantor8.tech") */
-    universalLinkBase?: string;
-    /** Connect endpoint path */
-    connectEndpoint?: string;
-    /** Sign endpoint path */
-    signEndpoint?: string;
-    /** Job status endpoint path (for async approvals) */
-    statusEndpoint?: string;
-    /** Redirect URI for callbacks */
-    redirectUri?: string;
+interface Cantor8SubmitPayload {
+    note?: string;
+    partyId: string;
+    commandId: string;
+    commandsJson: string;
+    disclosedContracts?: string;
 }
 /**
- * Vendor module interface
- *
- * Implementations can be swapped without changing adapter code.
+ * Cantor8 adapter configuration.
  */
-interface Cantor8VendorModule {
-    /**
-     * Create connect URL
-     */
-    createConnectUrl(request: ConnectRequest, config: Cantor8VendorConfig): string;
-    /**
-     * Parse connect callback
-     */
-    parseConnectCallback(callbackData: unknown, expectedState: string): ConnectResponse;
-    /**
-     * Create sign URL
-     */
-    createSignUrl(request: SignRequest, config: Cantor8VendorConfig): string;
-    /**
-     * Parse sign callback
-     */
-    parseSignCallback(callbackData: unknown, expectedState: string): SignResponse;
+interface Cantor8AdapterConfig {
+    /** dApp URL passed to the Cantor8 SDK popup handshake. Defaults to `ctx.origin`. */
+    dappUrl?: string;
     /**
-     * Poll job status (optional, for async approvals)
+     * How long `detectInstalled()` waits for the wallet's `c8#provider_discovery`
+     * announcement before reporting not-detected. Default 300ms.
      */
-    pollJobStatus?(jobId: string, statusUrl: string, timeoutMs: number): Promise<JobStatus>;
-}
-
-/**
- * Cantor8 adapter configuration
- */
-interface Cantor8AdapterConfig {
-    /** Vendor module (defaults to stub) */
-    vendorModule?: Cantor8VendorModule;
-    /** Vendor configuration */
-    vendorConfig?: Cantor8VendorConfig;
-    /** Use mock transport in development */
-    useMockTransport?: boolean;
+    detectTimeoutMs?: number;
 }
 /**
- * Cantor8 Wallet Adapter
+ * Cantor8 Wallet Adapter.
  */
 declare class Cantor8Adapter implements WalletAdapter {
     readonly walletId: _partylayer_core.WalletId;
     readonly name = "Cantor8";
-    private vendorModule;
-    private vendorConfig;
-    private transport;
+    private readonly config;
+    private provider;
     constructor(config?: Cantor8AdapterConfig);
     getCapabilities(): CapabilityKey[];
+    /** The SDK supports devnet and mainnet only; anything else fails at connect. */
+    private mapNetwork;
     detectInstalled(): Promise<AdapterDetectResult>;
-    connect(ctx: AdapterContext, opts?: {
+    connect(ctx: AdapterContext, _opts?: {
         timeoutMs?: number;
-        partyId?: _partylayer_core.PartyId;
     }): Promise<AdapterConnectResult>;
-    disconnect(_ctx: AdapterContext, _session: _partylayer_core.Session): Promise<void>;
-    restore(_ctx: AdapterContext, persisted: _partylayer_core.PersistedSession): Promise<_partylayer_core.Session | null>;
-    signMessage(ctx: AdapterContext, session: _partylayer_core.Session, params: SignMessageParams): Promise<_partylayer_core.SignedMessage>;
-    signTransaction(ctx: AdapterContext, session: _partylayer_core.Session, params: SignTransactionParams): Promise<_partylayer_core.SignedTransaction>;
+    disconnect(_ctx: AdapterContext, _session: Session): Promise<void>;
+    /**
+     * Cantor8 has NO arbitrary-message signing. Per the honesty rule: do not
+     * simulate it, do not route it through `signAndExecute` (which is for
+     * transactions), and do not silently succeed. Fail with the typed capability
+     * error. `signMessage` is also absent from `getCapabilities()`, so the SDK's
+     * capability guard blocks it first; this is the belt-and-suspenders backstop.
+     */
+    signMessage(_ctx: AdapterContext, _session: Session, _params: SignMessageParams): Promise<SignedMessage>;
+    /**
+     * Submit a transaction through the SDK's `signAndExecute` (sign + execute
+     * fused; the wallet has no separate sign step). `params.signedTx` is passed
+     * through: the caller owns its shape, which must be a {@link Cantor8SubmitPayload}.
+     *
+     * The SDK's `signAndExecute` resolves with no id; Cantor8 delivers the
+     * on-ledger txId and status asynchronously via the `txChanged` event (surfaced
+     * through `on('txStatus')`). The receipt is therefore keyed on the
+     * caller-supplied `commandId`; the confirmed ledger id arrives on the event
+     * stream. A live run against the real wallet is required to confirm
+     * end-to-end execution.
+     */
+    submitTransaction(_ctx: AdapterContext, _session: Session, params: SubmitTransactionParams): Promise<TxReceipt>;
     /**
-     * Generate random state nonce
+     * Forward the wallet's transaction-status stream. Cantor8 emits `txChanged`
+     * ({ txId, status }); PartyLayer surfaces this as the `events` capability under
+     * the `txStatus` event. Any other event name is a no-op. Returns an
+     * unsubscribe function.
      */
-    private generateState;
+    on(event: AdapterEventName, handler: (payload: unknown) => void): () => void;
 }
 
-export { Cantor8Adapter, type Cantor8AdapterConfig };
+export { Cantor8Adapter, type Cantor8AdapterConfig, type Cantor8SubmitPayload };