@cookill/wallet-adapter 3.0.0 → 3.1.1

package/dist/index.d.cts

@@ -1,6 +1,11 @@
 /**
- * @cookill/wallet-adapter v3.0.0
+ * @cookill/wallet-adapter v3.1.0
  * Core type definitions
+ *
+ * Includes support for:
+ * - REX (Rialo Extended Execution) — confidential computation transactions
+ * - SfS (Stake-for-Service) — gasless transactions via staking yield
+ * - Scan-to-Connect — QR-based cross-device wallet pairing
  */
 type RialoNetwork = 'mainnet' | 'testnet' | 'devnet' | 'localnet';
 type RialoChainId = `rialo:${RialoNetwork}`;
@@ -12,6 +17,8 @@ interface NetworkConfig {
     explorerUrl?: string;
     symbol: string;
     decimals: number;
+    supportsREX?: boolean;
+    supportsSfS?: boolean;
 }
 declare const NETWORKS: Record<RialoNetwork, NetworkConfig>;
 interface WalletAccount {
@@ -24,12 +31,20 @@ interface TransactionRequest {
     value: string;
     data?: string;
     memo?: string;
+    /** If true, attempt to pay gas via Stake-for-Service credits */
+    gasless?: boolean;
+    /** REX confidential execution context */
+    rex?: REXConfig;
 }
 interface TransactionResult {
     hash: string;
     signature?: string;
     status: 'pending' | 'confirmed' | 'failed';
     blockNumber?: number;
+    /** Whether gas was paid via SfS credits */
+    gasless?: boolean;
+    /** REX execution proof if confidential */
+    rexProof?: string;
 }
 interface SignedMessage {
     signature: string;
@@ -41,14 +56,151 @@ interface BalanceResult {
     balance: string;
     formatted: string;
 }
+/**
+ * REX enables privacy-preserving computation on Rialo.
+ * Transactions can be executed confidentially using TEEs, MPC, or FHE
+ * without exposing inputs to the public blockchain.
+ */
+/** Privacy technology used for confidential computation */
+type REXPrivacyMode = 'tee' | 'mpc' | 'fhe' | 'auto';
+interface REXConfig {
+    /** Enable confidential execution */
+    confidential: boolean;
+    /** Privacy technology to use (default: 'auto' — protocol selects optimal) */
+    privacyMode?: REXPrivacyMode;
+    /** Encrypted inputs (base64-encoded ciphertext) */
+    encryptedInputs?: string;
+    /** REX program ID to execute */
+    programId?: string;
+    /** Whether output should remain encrypted for future computation */
+    keepEncrypted?: boolean;
+    /** Access control — who can decrypt the result */
+    accessPolicy?: REXAccessPolicy;
+}
+interface REXAccessPolicy {
+    /** Addresses allowed to decrypt the result */
+    allowedDecryptors: string[];
+    /** Expiry timestamp (ms) for access */
+    expiresAt?: number;
+}
+interface REXTransactionResult extends TransactionResult {
+    /** Attestation proof from TEE/MPC */
+    attestation?: string;
+    /** Encrypted output (if keepEncrypted was true) */
+    encryptedOutput?: string;
+    /** Public output (if computation produced public results) */
+    publicOutput?: string;
+}
+/** REX capabilities query result */
+interface REXCapabilities {
+    supported: boolean;
+    privacyModes: REXPrivacyMode[];
+    maxInputSize: number;
+    programs: string[];
+}
+/**
+ * SfS converts staking yield into service credits that automatically
+ * pay for network costs (gas, storage, scheduled executions).
+ * Users stake RLO, set a routing fraction, and the ServicePaymaster
+ * mints credits from their yield.
+ */
+interface SfSPosition {
+    /** Position ID */
+    id: string;
+    /** Staked principal in kelvins */
+    principal: string;
+    /** Validator/pool receiving the delegation */
+    validator: string;
+    /** Fraction of yield routed to service credits (0.0 - 1.0) */
+    routingFraction: number;
+    /** Current service credit balance */
+    creditBalance: string;
+    /** Estimated credits per epoch */
+    creditsPerEpoch: string;
+    /** Position status */
+    status: 'active' | 'pending' | 'closed';
+    /** Creation timestamp */
+    createdAt: number;
+}
+interface SfSCreateParams {
+    /** Amount of RLO to stake (in kelvins) */
+    amount: string;
+    /** Validator address to delegate to */
+    validator: string;
+    /** Fraction of yield to route to service credits (0.0 - 1.0) */
+    routingFraction: number;
+}
+interface SfSUpdateParams {
+    /** Position ID to update */
+    positionId: string;
+    /** New routing fraction (0.0 - 1.0) */
+    routingFraction?: number;
+}
+interface SfSCreditBalance {
+    /** Available service credits */
+    available: string;
+    /** Credits used this epoch */
+    usedThisEpoch: string;
+    /** Total credits earned */
+    totalEarned: string;
+    /** Estimated credits per epoch */
+    estimatedPerEpoch: string;
+}
+/**
+ * Enables connecting a wallet on one device to a dApp on another device
+ * via QR code scanning. Supports bidirectional flow:
+ * - dApp shows QR → wallet scans to connect
+ * - Wallet shows QR → dApp scans to connect
+ */
+interface ScanConnectSession {
+    /** Unique session identifier */
+    sessionId: string;
+    /** Session topic for relay */
+    topic: string;
+    /** Relay server URL */
+    relay: string;
+    /** Session encryption key (hex) */
+    symmetricKey: string;
+    /** Originator: 'dapp' or 'wallet' */
+    origin: 'dapp' | 'wallet';
+    /** dApp metadata */
+    dappMetadata?: ScanConnectDAppMetadata;
+    /** Wallet metadata */
+    walletMetadata?: ScanConnectWalletMetadata;
+    /** Requested chain IDs */
+    chains: RialoChainId[];
+    /** Expiry timestamp */
+    expiresAt: number;
+}
+interface ScanConnectDAppMetadata {
+    name: string;
+    url: string;
+    icon?: string;
+    description?: string;
+}
+interface ScanConnectWalletMetadata {
+    name: string;
+    icon?: string;
+    version?: string;
+}
+/** URI format for scan-to-connect QR codes */
+interface ScanConnectURI {
+    /** Full URI string (rialo-wc://...) */
+    uri: string;
+    /** Parsed session info */
+    session: ScanConnectSession;
+}
 interface WalletInfo {
     id: string;
     name: string;
     icon: string;
     installed?: boolean;
     downloadUrl?: string;
+    supportsREX?: boolean;
+    supportsSfS?: boolean;
+    supportsScanConnect?: boolean;
 }
-type WalletEventType = 'connect' | 'disconnect' | 'accountsChanged' | 'networkChanged' | 'chainChanged' | 'error';
+type WalletEventType = 'connect' | 'disconnect' | 'accountsChanged' | 'networkChanged' | 'chainChanged' | 'scanConnect' | 'sfsUpdate' | 'error';
 interface RialoProvider {
     isRialo: boolean;
     isSheepWallet?: boolean;
@@ -71,6 +223,18 @@ interface RialoProvider {
         success: boolean;
     }>;
     getBalance(address?: string): Promise<BalanceResult | string>;
+    getREXCapabilities?(): Promise<REXCapabilities>;
+    submitREXTransaction?(tx: TransactionRequest): Promise<REXTransactionResult>;
+    getSfSPositions?(): Promise<SfSPosition[]>;
+    createSfSPosition?(params: SfSCreateParams): Promise<SfSPosition>;
+    updateSfSPosition?(params: SfSUpdateParams): Promise<SfSPosition>;
+    closeSfSPosition?(positionId: string): Promise<{
+        success: boolean;
+    }>;
+    getSfSCredits?(): Promise<SfSCreditBalance>;
+    createScanSession?(origin: 'wallet'): Promise<ScanConnectURI>;
+    approveScanSession?(sessionId: string): Promise<WalletAccount[]>;
+    rejectScanSession?(sessionId: string): Promise<void>;
     on(event: WalletEventType, callback: (data: unknown) => void): () => void;
     removeListener(event: WalletEventType, callback: (data: unknown) => void): void;
     removeAllListeners(event?: WalletEventType): void;
@@ -147,9 +311,15 @@ declare function fromChainId(chainId: RialoChainId): RialoNetwork;
 declare function normalizeAccounts(accounts: Array<string | WalletAccount>): WalletAccount[];
 
 /**
- * @cookill/wallet-adapter v3.0.0
+ * @cookill/wallet-adapter v3.1.0
  * Pure JavaScript wallet class (no React dependency)
  *
+ * Supports:
+ * - Standard connect/disconnect/sign operations
+ * - REX (Rialo Extended Execution) confidential transactions
+ * - SfS (Stake-for-Service) gasless transactions
+ * - Scan-to-Connect QR-based pairing
+ *
  * Usage:
  *   const wallet = new SheepWallet();
  *   if (!wallet.isInstalled) { ... prompt install ... }
@@ -177,6 +347,56 @@ declare class SheepWallet {
     signTransaction(tx: TransactionRequest): Promise<string>;
     sendTransaction(tx: TransactionRequest): Promise<TransactionResult>;
     signAndSendTransaction(tx: TransactionRequest): Promise<TransactionResult>;
+    /**
+     * Check if the connected wallet/network supports REX
+     */
+    getREXCapabilities(): Promise<REXCapabilities>;
+    /**
+     * Submit a confidential transaction via REX
+     * The transaction inputs are encrypted and executed in a TEE/MPC/FHE environment
+     */
+    submitREXTransaction(tx: TransactionRequest): Promise<REXTransactionResult>;
+    /**
+     * Send a gasless transaction using Stake-for-Service credits
+     * Automatically sets tx.gasless = true
+     */
+    sendGaslessTransaction(tx: Omit<TransactionRequest, 'gasless'>): Promise<TransactionResult>;
+    /**
+     * Get all Stake-for-Service positions for the connected account
+     */
+    getSfSPositions(): Promise<SfSPosition[]>;
+    /**
+     * Create a new Stake-for-Service position
+     * Stakes RLO and routes a fraction of yield to service credits
+     */
+    createSfSPosition(params: SfSCreateParams): Promise<SfSPosition>;
+    /**
+     * Update an existing SfS position (e.g., change routing fraction)
+     */
+    updateSfSPosition(params: SfSUpdateParams): Promise<SfSPosition>;
+    /**
+     * Close an SfS position and unstake
+     */
+    closeSfSPosition(positionId: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Get current SfS service credit balance
+     */
+    getSfSCredits(): Promise<SfSCreditBalance>;
+    /**
+     * Generate a scan-to-connect URI from the wallet side
+     * Returns a URI that can be displayed as QR code for dApps to scan
+     */
+    createScanSession(): Promise<ScanConnectURI>;
+    /**
+     * Approve a scan-to-connect session (after wallet scans dApp QR)
+     */
+    approveScanSession(sessionId: string): Promise<WalletAccount[]>;
+    /**
+     * Reject a scan-to-connect session
+     */
+    rejectScanSession(sessionId: string): Promise<void>;
     getBalance(address?: string): Promise<string>;
     switchNetwork(network: RialoNetwork): Promise<void>;
     on(event: string, callback: (data: unknown) => void): () => void;

package/dist/index.d.ts

@@ -1,6 +1,11 @@
 /**
- * @cookill/wallet-adapter v3.0.0
+ * @cookill/wallet-adapter v3.1.0
  * Core type definitions
+ *
+ * Includes support for:
+ * - REX (Rialo Extended Execution) — confidential computation transactions
+ * - SfS (Stake-for-Service) — gasless transactions via staking yield
+ * - Scan-to-Connect — QR-based cross-device wallet pairing
  */
 type RialoNetwork = 'mainnet' | 'testnet' | 'devnet' | 'localnet';
 type RialoChainId = `rialo:${RialoNetwork}`;
@@ -12,6 +17,8 @@ interface NetworkConfig {
     explorerUrl?: string;
     symbol: string;
     decimals: number;
+    supportsREX?: boolean;
+    supportsSfS?: boolean;
 }
 declare const NETWORKS: Record<RialoNetwork, NetworkConfig>;
 interface WalletAccount {
@@ -24,12 +31,20 @@ interface TransactionRequest {
     value: string;
     data?: string;
     memo?: string;
+    /** If true, attempt to pay gas via Stake-for-Service credits */
+    gasless?: boolean;
+    /** REX confidential execution context */
+    rex?: REXConfig;
 }
 interface TransactionResult {
     hash: string;
     signature?: string;
     status: 'pending' | 'confirmed' | 'failed';
     blockNumber?: number;
+    /** Whether gas was paid via SfS credits */
+    gasless?: boolean;
+    /** REX execution proof if confidential */
+    rexProof?: string;
 }
 interface SignedMessage {
     signature: string;
@@ -41,14 +56,151 @@ interface BalanceResult {
     balance: string;
     formatted: string;
 }
+/**
+ * REX enables privacy-preserving computation on Rialo.
+ * Transactions can be executed confidentially using TEEs, MPC, or FHE
+ * without exposing inputs to the public blockchain.
+ */
+/** Privacy technology used for confidential computation */
+type REXPrivacyMode = 'tee' | 'mpc' | 'fhe' | 'auto';
+interface REXConfig {
+    /** Enable confidential execution */
+    confidential: boolean;
+    /** Privacy technology to use (default: 'auto' — protocol selects optimal) */
+    privacyMode?: REXPrivacyMode;
+    /** Encrypted inputs (base64-encoded ciphertext) */
+    encryptedInputs?: string;
+    /** REX program ID to execute */
+    programId?: string;
+    /** Whether output should remain encrypted for future computation */
+    keepEncrypted?: boolean;
+    /** Access control — who can decrypt the result */
+    accessPolicy?: REXAccessPolicy;
+}
+interface REXAccessPolicy {
+    /** Addresses allowed to decrypt the result */
+    allowedDecryptors: string[];
+    /** Expiry timestamp (ms) for access */
+    expiresAt?: number;
+}
+interface REXTransactionResult extends TransactionResult {
+    /** Attestation proof from TEE/MPC */
+    attestation?: string;
+    /** Encrypted output (if keepEncrypted was true) */
+    encryptedOutput?: string;
+    /** Public output (if computation produced public results) */
+    publicOutput?: string;
+}
+/** REX capabilities query result */
+interface REXCapabilities {
+    supported: boolean;
+    privacyModes: REXPrivacyMode[];
+    maxInputSize: number;
+    programs: string[];
+}
+/**
+ * SfS converts staking yield into service credits that automatically
+ * pay for network costs (gas, storage, scheduled executions).
+ * Users stake RLO, set a routing fraction, and the ServicePaymaster
+ * mints credits from their yield.
+ */
+interface SfSPosition {
+    /** Position ID */
+    id: string;
+    /** Staked principal in kelvins */
+    principal: string;
+    /** Validator/pool receiving the delegation */
+    validator: string;
+    /** Fraction of yield routed to service credits (0.0 - 1.0) */
+    routingFraction: number;
+    /** Current service credit balance */
+    creditBalance: string;
+    /** Estimated credits per epoch */
+    creditsPerEpoch: string;
+    /** Position status */
+    status: 'active' | 'pending' | 'closed';
+    /** Creation timestamp */
+    createdAt: number;
+}
+interface SfSCreateParams {
+    /** Amount of RLO to stake (in kelvins) */
+    amount: string;
+    /** Validator address to delegate to */
+    validator: string;
+    /** Fraction of yield to route to service credits (0.0 - 1.0) */
+    routingFraction: number;
+}
+interface SfSUpdateParams {
+    /** Position ID to update */
+    positionId: string;
+    /** New routing fraction (0.0 - 1.0) */
+    routingFraction?: number;
+}
+interface SfSCreditBalance {
+    /** Available service credits */
+    available: string;
+    /** Credits used this epoch */
+    usedThisEpoch: string;
+    /** Total credits earned */
+    totalEarned: string;
+    /** Estimated credits per epoch */
+    estimatedPerEpoch: string;
+}
+/**
+ * Enables connecting a wallet on one device to a dApp on another device
+ * via QR code scanning. Supports bidirectional flow:
+ * - dApp shows QR → wallet scans to connect
+ * - Wallet shows QR → dApp scans to connect
+ */
+interface ScanConnectSession {
+    /** Unique session identifier */
+    sessionId: string;
+    /** Session topic for relay */
+    topic: string;
+    /** Relay server URL */
+    relay: string;
+    /** Session encryption key (hex) */
+    symmetricKey: string;
+    /** Originator: 'dapp' or 'wallet' */
+    origin: 'dapp' | 'wallet';
+    /** dApp metadata */
+    dappMetadata?: ScanConnectDAppMetadata;
+    /** Wallet metadata */
+    walletMetadata?: ScanConnectWalletMetadata;
+    /** Requested chain IDs */
+    chains: RialoChainId[];
+    /** Expiry timestamp */
+    expiresAt: number;
+}
+interface ScanConnectDAppMetadata {
+    name: string;
+    url: string;
+    icon?: string;
+    description?: string;
+}
+interface ScanConnectWalletMetadata {
+    name: string;
+    icon?: string;
+    version?: string;
+}
+/** URI format for scan-to-connect QR codes */
+interface ScanConnectURI {
+    /** Full URI string (rialo-wc://...) */
+    uri: string;
+    /** Parsed session info */
+    session: ScanConnectSession;
+}
 interface WalletInfo {
     id: string;
     name: string;
     icon: string;
     installed?: boolean;
     downloadUrl?: string;
+    supportsREX?: boolean;
+    supportsSfS?: boolean;
+    supportsScanConnect?: boolean;
 }
-type WalletEventType = 'connect' | 'disconnect' | 'accountsChanged' | 'networkChanged' | 'chainChanged' | 'error';
+type WalletEventType = 'connect' | 'disconnect' | 'accountsChanged' | 'networkChanged' | 'chainChanged' | 'scanConnect' | 'sfsUpdate' | 'error';
 interface RialoProvider {
     isRialo: boolean;
     isSheepWallet?: boolean;
@@ -71,6 +223,18 @@ interface RialoProvider {
         success: boolean;
     }>;
     getBalance(address?: string): Promise<BalanceResult | string>;
+    getREXCapabilities?(): Promise<REXCapabilities>;
+    submitREXTransaction?(tx: TransactionRequest): Promise<REXTransactionResult>;
+    getSfSPositions?(): Promise<SfSPosition[]>;
+    createSfSPosition?(params: SfSCreateParams): Promise<SfSPosition>;
+    updateSfSPosition?(params: SfSUpdateParams): Promise<SfSPosition>;
+    closeSfSPosition?(positionId: string): Promise<{
+        success: boolean;
+    }>;
+    getSfSCredits?(): Promise<SfSCreditBalance>;
+    createScanSession?(origin: 'wallet'): Promise<ScanConnectURI>;
+    approveScanSession?(sessionId: string): Promise<WalletAccount[]>;
+    rejectScanSession?(sessionId: string): Promise<void>;
     on(event: WalletEventType, callback: (data: unknown) => void): () => void;
     removeListener(event: WalletEventType, callback: (data: unknown) => void): void;
     removeAllListeners(event?: WalletEventType): void;
@@ -147,9 +311,15 @@ declare function fromChainId(chainId: RialoChainId): RialoNetwork;
 declare function normalizeAccounts(accounts: Array<string | WalletAccount>): WalletAccount[];
 
 /**
- * @cookill/wallet-adapter v3.0.0
+ * @cookill/wallet-adapter v3.1.0
  * Pure JavaScript wallet class (no React dependency)
  *
+ * Supports:
+ * - Standard connect/disconnect/sign operations
+ * - REX (Rialo Extended Execution) confidential transactions
+ * - SfS (Stake-for-Service) gasless transactions
+ * - Scan-to-Connect QR-based pairing
+ *
  * Usage:
  *   const wallet = new SheepWallet();
  *   if (!wallet.isInstalled) { ... prompt install ... }
@@ -177,6 +347,56 @@ declare class SheepWallet {
     signTransaction(tx: TransactionRequest): Promise<string>;
     sendTransaction(tx: TransactionRequest): Promise<TransactionResult>;
     signAndSendTransaction(tx: TransactionRequest): Promise<TransactionResult>;
+    /**
+     * Check if the connected wallet/network supports REX
+     */
+    getREXCapabilities(): Promise<REXCapabilities>;
+    /**
+     * Submit a confidential transaction via REX
+     * The transaction inputs are encrypted and executed in a TEE/MPC/FHE environment
+     */
+    submitREXTransaction(tx: TransactionRequest): Promise<REXTransactionResult>;
+    /**
+     * Send a gasless transaction using Stake-for-Service credits
+     * Automatically sets tx.gasless = true
+     */
+    sendGaslessTransaction(tx: Omit<TransactionRequest, 'gasless'>): Promise<TransactionResult>;
+    /**
+     * Get all Stake-for-Service positions for the connected account
+     */
+    getSfSPositions(): Promise<SfSPosition[]>;
+    /**
+     * Create a new Stake-for-Service position
+     * Stakes RLO and routes a fraction of yield to service credits
+     */
+    createSfSPosition(params: SfSCreateParams): Promise<SfSPosition>;
+    /**
+     * Update an existing SfS position (e.g., change routing fraction)
+     */
+    updateSfSPosition(params: SfSUpdateParams): Promise<SfSPosition>;
+    /**
+     * Close an SfS position and unstake
+     */
+    closeSfSPosition(positionId: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Get current SfS service credit balance
+     */
+    getSfSCredits(): Promise<SfSCreditBalance>;
+    /**
+     * Generate a scan-to-connect URI from the wallet side
+     * Returns a URI that can be displayed as QR code for dApps to scan
+     */
+    createScanSession(): Promise<ScanConnectURI>;
+    /**
+     * Approve a scan-to-connect session (after wallet scans dApp QR)
+     */
+    approveScanSession(sessionId: string): Promise<WalletAccount[]>;
+    /**
+     * Reject a scan-to-connect session
+     */
+    rejectScanSession(sessionId: string): Promise<void>;
     getBalance(address?: string): Promise<string>;
     switchNetwork(network: RialoNetwork): Promise<void>;
     on(event: string, callback: (data: unknown) => void): () => void;