@idosgames/wallet 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,335 @@
+import { E as EvmBridgeClients, W as WalletLoginResult } from './bridge-BCxf6AHE.js';
+export { B as BridgeFailure, a as BridgeResult, b as BridgeStage, c as BridgeSuccess, D as DepositNft721EvmParams, d as DepositNftEvmParams, e as DepositTokenEvmParams, f as DepositTokenSolanaParams, S as SolanaProgramAdapter, g as WalletLoginFailure, h as WalletLoginStage, i as WalletLoginSuccess, j as WithdrawNftEvmParams, k as WithdrawTokenEvmParams, l as WithdrawTokenSolanaParams, m as bridgeFail, n as depositNftEvm, o as depositNftEvm721, p as depositTokenEvm, q as depositTokenSolana, r as ensureErc20Allowance, s as submitEvmNftWithdrawal, t as submitEvmNftWithdrawal721, u as submitEvmTokenWithdrawal, v as toErrorMessage, w as walletLoginFail, x as withdrawNftEvm, y as withdrawTokenEvm, z as withdrawTokenSolana, A as writeAndWait } from './bridge-BCxf6AHE.js';
+import { Hex } from 'viem';
+import { IDosGamesClient, ClientState } from '@idosgames/core';
+
+declare const rewardPoolAbi: readonly [{
+    readonly type: "function";
+    readonly name: "depositERC20";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "userID";
+        readonly type: "string";
+    }, {
+        readonly name: "titleID";
+        readonly type: "string";
+    }, {
+        readonly name: "category";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "withdrawERC20";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "burnAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "nonce";
+        readonly type: "uint256";
+    }, {
+        readonly name: "signature";
+        readonly type: "bytes";
+    }, {
+        readonly name: "userID";
+        readonly type: "string";
+    }, {
+        readonly name: "titleID";
+        readonly type: "string";
+    }, {
+        readonly name: "category";
+        readonly type: "string";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "withdrawERC1155";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "id";
+        readonly type: "uint256";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "nonce";
+        readonly type: "uint256";
+    }, {
+        readonly name: "signature";
+        readonly type: "bytes";
+    }, {
+        readonly name: "userID";
+        readonly type: "string";
+    }, {
+        readonly name: "titleID";
+        readonly type: "string";
+    }, {
+        readonly name: "category";
+        readonly type: "string";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "withdrawERC721";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "tokenId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "nonce";
+        readonly type: "uint256";
+    }, {
+        readonly name: "signature";
+        readonly type: "bytes";
+    }, {
+        readonly name: "userID";
+        readonly type: "string";
+    }, {
+        readonly name: "titleID";
+        readonly type: "string";
+    }, {
+        readonly name: "category";
+        readonly type: "string";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}];
+/** Minimal ERC-20 surface the bridge needs (approve/allowance for deposits, decimals/balance for UX). */
+declare const erc20Abi: readonly [{
+    readonly type: "function";
+    readonly name: "approve";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "allowance";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "decimals";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint8";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "balanceOf";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}];
+/**
+ * Minimal ERC-1155 surface. NFT deposits go through the collection contract's own
+ * `safeTransferFrom(from, to=pool, id, amount, data)`, where `data` carries the ABI-encoded
+ * (userID, titleID, category) the receiving RewardPool decodes — see {@link encodeNftDepositData}.
+ */
+declare const erc1155Abi: readonly [{
+    readonly type: "function";
+    readonly name: "safeTransferFrom";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "from";
+        readonly type: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "id";
+        readonly type: "uint256";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "data";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "isApprovedForAll";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }, {
+        readonly name: "operator";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "setApprovalForAll";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "operator";
+        readonly type: "address";
+    }, {
+        readonly name: "approved";
+        readonly type: "bool";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "balanceOf";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }, {
+        readonly name: "id";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}];
+/**
+ * Minimal ERC-721 surface. NFT deposits go through the collection contract's own 4-arg
+ * `safeTransferFrom(from, to=pool, tokenId, data)`, where `data` carries the ABI-encoded
+ * (userID, titleID, category) the receiving RewardPool decodes — see {@link encodeNftDepositData}.
+ */
+declare const erc721Abi: readonly [{
+    readonly type: "function";
+    readonly name: "safeTransferFrom";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "from";
+        readonly type: "address";
+    }, {
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "tokenId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "data";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [];
+}];
+
+/**
+ * Builds the `data` blob for an ERC-1155 NFT deposit's `safeTransferFrom`.
+ *
+ * The updated RewardPool decodes this as `abi.encode(string userID, string titleID, string
+ * category)` — see RewardPoolEvmV2.GetDepositIdsFromNftTransferData / DepositIdsOutput on the
+ * backend. The three fields must be a non-packed ABI encode of exactly (string, string, string)
+ * in that order, or the receiver can't attribute the deposit and the backend rejects it with
+ * "Cannot extract userID from transaction."
+ */
+declare function encodeNftDepositData(userID: string, titleID: string, category?: string): Hex;
+
+interface LoginWithWalletEvmParams {
+    client: IDosGamesClient;
+    clients: EvmBridgeClients;
+    /** NetworkID (key of cfg.Blockchain.Networks) the wallet proves ownership on. Must be an EVM network. */
+    networkID: string;
+    /** Address to authenticate; defaults to the connected `clients.account`. */
+    walletAddress?: string;
+}
+/**
+ * Full EVM wallet-login flow: `requestWalletChallenge` → `personal_sign` the returned message with
+ * the connected wallet → `loginWithWallet`. On success the core client is logged in (auth context
+ * applied, client state fetched) and the fresh {@link ClientState} is returned.
+ *
+ * No on-chain transaction and no gas — this is an off-chain signature proving wallet ownership.
+ * A user-rejected signature surfaces as a `{ ok: false, stage: "sign" }` failure, not a throw.
+ */
+declare function loginWithWalletEvm(params: LoginWithWalletEvmParams): Promise<WalletLoginResult<ClientState>>;
+
+/**
+ * A wallet-adapter message signer: signs raw bytes and returns the 64-byte ed25519 signature.
+ * This is exactly the shape of `@solana/wallet-adapter-react`'s `useWallet().signMessage`.
+ */
+type SolanaMessageSigner = (message: Uint8Array) => Promise<Uint8Array>;
+interface LoginWithWalletSolanaParams {
+    client: IDosGamesClient;
+    /** NetworkID (key of cfg.Blockchain.Networks) the wallet proves ownership on. Must be a Solana network. */
+    networkID: string;
+    /** The connected wallet's base58 address (owner pubkey). */
+    walletAddress: string;
+    /** The connected wallet's message signer (e.g. `useWallet().signMessage`). */
+    signMessage: SolanaMessageSigner;
+}
+/**
+ * Full Solana wallet-login flow: `requestWalletChallenge` → sign the returned message bytes with
+ * the connected wallet (`signMessage`) → `loginWithWallet`. The signature is sent as 0x-hex, which
+ * the backend decodes unambiguously (base58/base64 ed25519 signatures can collide with each other's
+ * alphabets, so hex avoids the guesswork). On success the core client is logged in and the fresh
+ * {@link ClientState} is returned. No on-chain transaction — off-chain proof of ownership only.
+ */
+declare function loginWithWalletSolana(params: LoginWithWalletSolanaParams): Promise<WalletLoginResult<ClientState>>;
+
+export { EvmBridgeClients, type LoginWithWalletEvmParams, type LoginWithWalletSolanaParams, type SolanaMessageSigner, WalletLoginResult, encodeNftDepositData, erc1155Abi, erc20Abi, erc721Abi, loginWithWalletEvm, loginWithWalletSolana, rewardPoolAbi };

package/dist/index.js

@@ -0,0 +1 @@
+export{b as bridgeFail,l as depositNftEvm,m as depositNftEvm721,k as depositTokenEvm,t as depositTokenSolana,h as encodeNftDepositData,j as ensureErc20Allowance,f as erc1155Abi,e as erc20Abi,g as erc721Abi,s as loginWithWalletEvm,v as loginWithWalletSolana,d as rewardPoolAbi,o as submitEvmNftWithdrawal,p as submitEvmNftWithdrawal721,n as submitEvmTokenWithdrawal,a as toErrorMessage,c as walletLoginFail,r as withdrawNftEvm,q as withdrawTokenEvm,u as withdrawTokenSolana,i as writeAndWait}from'./chunk-Q6C5EFPV.js';

package/dist/react/index.cjs

@@ -0,0 +1 @@
+'use strict';var wagmi=require('wagmi'),connectors=require('wagmi/connectors'),reactQuery=require('@tanstack/react-query'),react=require('react'),jsxRuntime=require('react/jsx-runtime'),viem=require('viem'),core=require('@idosgames/core'),walletAdapterReact=require('@solana/wallet-adapter-react');function _(t){let{chains:e,walletConnectProjectId:n,appName:r,appUrl:s,appIcon:i,transports:l,connectors:p}=t,o=r||s?{name:r??"iDosGames",description:r??"iDosGames game",url:s??"",icons:i?[i]:[]}:void 0,m=p??[connectors.injected(),connectors.coinbaseWallet({appName:r??"iDosGames"}),...n?[connectors.walletConnect({projectId:n,metadata:o,showQrModal:true})]:[]],d={};for(let c of e)d[c.id]=l?.[c.id]??wagmi.http();return wagmi.createConfig({chains:e,connectors:m,transports:d})}function Y(t){let{wagmiConfig:e,queryClient:n,children:r}=t,[s]=react.useState(()=>n??new reactQuery.QueryClient);return jsxRuntime.jsx(wagmi.WagmiProvider,{config:e,children:jsxRuntime.jsx(reactQuery.QueryClientProvider,{client:s,children:r})})}var k=[{type:"function",name:"depositERC20",stateMutability:"nonpayable",inputs:[{name:"token",type:"address"},{name:"amount",type:"uint256"},{name:"userID",type:"string"},{name:"titleID",type:"string"},{name:"category",type:"string"}],outputs:[{name:"",type:"bool"}]},{type:"function",name:"withdrawERC20",stateMutability:"nonpayable",inputs:[{name:"token",type:"address"},{name:"to",type:"address"},{name:"amount",type:"uint256"},{name:"burnAmount",type:"uint256"},{name:"nonce",type:"uint256"},{name:"signature",type:"bytes"},{name:"userID",type:"string"},{name:"titleID",type:"string"},{name:"category",type:"string"},{name:"deadline",type:"uint256"}],outputs:[]},{type:"function",name:"withdrawERC1155",stateMutability:"nonpayable",inputs:[{name:"token",type:"address"},{name:"to",type:"address"},{name:"id",type:"uint256"},{name:"amount",type:"uint256"},{name:"nonce",type:"uint256"},{name:"signature",type:"bytes"},{name:"userID",type:"string"},{name:"titleID",type:"string"},{name:"category",type:"string"},{name:"deadline",type:"uint256"}],outputs:[]},{type:"function",name:"withdrawERC721",stateMutability:"nonpayable",inputs:[{name:"token",type:"address"},{name:"to",type:"address"},{name:"tokenId",type:"uint256"},{name:"nonce",type:"uint256"},{name:"signature",type:"bytes"},{name:"userID",type:"string"},{name:"titleID",type:"string"},{name:"category",type:"string"},{name:"deadline",type:"uint256"}],outputs:[]}],E=[{type:"function",name:"withdrawERC1155Mint",stateMutability:"nonpayable",inputs:[{name:"collection",type:"address"},{name:"to",type:"address"},{name:"id",type:"uint256"},{name:"amount",type:"uint256"},{name:"nonce",type:"uint256"},{name:"signature",type:"bytes"},{name:"userID",type:"string"},{name:"titleID",type:"string"},{name:"category",type:"string"},{name:"deadline",type:"uint256"}],outputs:[]},{type:"function",name:"withdrawERC721Mint",stateMutability:"nonpayable",inputs:[{name:"collection",type:"address"},{name:"to",type:"address"},{name:"tokenId",type:"uint256"},{name:"nonce",type:"uint256"},{name:"signature",type:"bytes"},{name:"userID",type:"string"},{name:"titleID",type:"string"},{name:"category",type:"string"},{name:"deadline",type:"uint256"}],outputs:[]}],D=[{type:"function",name:"approve",stateMutability:"nonpayable",inputs:[{name:"spender",type:"address"},{name:"amount",type:"uint256"}],outputs:[{name:"",type:"bool"}]},{type:"function",name:"allowance",stateMutability:"view",inputs:[{name:"owner",type:"address"},{name:"spender",type:"address"}],outputs:[{name:"",type:"uint256"}]},{type:"function",name:"decimals",stateMutability:"view",inputs:[],outputs:[{name:"",type:"uint8"}]},{type:"function",name:"balanceOf",stateMutability:"view",inputs:[{name:"account",type:"address"}],outputs:[{name:"",type:"uint256"}]}],N=[{type:"function",name:"safeTransferFrom",stateMutability:"nonpayable",inputs:[{name:"from",type:"address"},{name:"to",type:"address"},{name:"id",type:"uint256"},{name:"amount",type:"uint256"},{name:"data",type:"bytes"}],outputs:[]},{type:"function",name:"isApprovedForAll",stateMutability:"view",inputs:[{name:"account",type:"address"},{name:"operator",type:"address"}],outputs:[{name:"",type:"bool"}]},{type:"function",name:"setApprovalForAll",stateMutability:"nonpayable",inputs:[{name:"operator",type:"address"},{name:"approved",type:"bool"}],outputs:[]},{type:"function",name:"balanceOf",stateMutability:"view",inputs:[{name:"account",type:"address"},{name:"id",type:"uint256"}],outputs:[{name:"",type:"uint256"}]}];function B(t,e,n){return viem.encodeAbiParameters([{type:"string"},{type:"string"},{type:"string"}],[t,e,core.normalizeBlockchainCategory(n)])}async function w(t,e){let{walletClient:n,publicClient:r,account:s}=t,i=await n.writeContract({address:e.address,abi:e.abi,functionName:e.functionName,args:e.args,account:s,chain:n.chain,value:e.value});if((await r.waitForTransactionReceipt({hash:i})).status==="reverted")throw new Error(`On-chain transaction reverted (${i}).`);return i}function g(t){return t instanceof viem.BaseError?t.shortMessage:t instanceof Error?t.message:String(t)}function a(t,e,n){return {ok:false,stage:t,error:e,...n}}function f(t,e){return {ok:false,stage:t,error:e}}function S(t){let e=t.PlatformPoolAddress;return e||null}async function R(t,e,n,r){return await t.publicClient.readContract({address:e,abi:D,functionName:"allowance",args:[t.account,n]})>=r?null:w(t,{address:e,abi:D,functionName:"approve",args:[n,r]})}async function T(t){let{client:e,clients:n,network:r,tokenAddress:s,amount:i,titleID:l,category:p}=t,o=e.auth.context?.userID;if(!o)return a("approve","Not logged in.");let m=S(r);if(!m)return a("approve","Network has no PlatformPoolAddress.");if(i<=0n)return a("approve","Amount must be positive.");try{await R(n,s,m,i);}catch(u){return a("approve",g(u))}let d;try{d=await w(n,{address:m,abi:k,functionName:"depositERC20",args:[s,i,o,l,p??""]});}catch(u){return a("deposit-onchain",g(u))}let c=await e.blockchain.depositToken(r.NetworkID??"",d);return c.ok?{ok:true,onChainTxHash:d,data:c.data}:a("report",c.error,{onChainTxHash:d})}async function C(t){let{client:e,clients:n,network:r,nftContractAddress:s,tokenId:i,amount:l,titleID:p,category:o}=t,m=e.auth.context?.userID;if(!m)return a("deposit-onchain","Not logged in.");let d=S(r);if(!d)return a("deposit-onchain","Network has no PlatformPoolAddress.");if(l<=0n)return a("deposit-onchain","Amount must be positive.");let c=B(m,p,o),u;try{u=await w(n,{address:s,abi:N,functionName:"safeTransferFrom",args:[n.account,d,i,l,c]});}catch(q){return a("deposit-onchain",g(q))}let y=await e.blockchain.depositNFT(r.NetworkID??"",u);return y.ok?{ok:true,onChainTxHash:u,data:y.data}:a("report",y.error,{onChainTxHash:u})}async function F(t,e){return w(t,{address:e.ContractAddress,abi:k,functionName:"withdrawERC20",args:[e.TokenAddress,e.WalletAddress,BigInt(e.Amount??"0"),BigInt(e.BurnAmount??"0"),BigInt(e.Nonce??"0"),e.Signature??"0x",e.UserID??"",e.TitleID??"",e.Category??"",BigInt(e.Deadline??"0")]})}async function M(t,e){return w(t,{address:e.ContractAddress,abi:E,functionName:"withdrawERC1155Mint",args:[e.TokenAddress,e.WalletAddress,BigInt(e.TokenId??"0"),BigInt(e.Amount??"0"),BigInt(e.Nonce??"0"),e.Signature??"0x",e.UserID??"",e.TitleID??"",e.Category??"",BigInt(e.Deadline??"0")]})}async function W(t){let{client:e,clients:n,currencyID:r,networkID:s,walletAddress:i,amount:l,category:p}=t,o=await e.blockchain.requestTokenWithdrawal(r,s,i,l,p);if(!o.ok)return a("request",o.error);let m=o.data.EvmSignature,d=o.data.TitleTransactionID??void 0;if(!m)return a("request","Withdrawal response carried no EVM signature.",{titleTransactionID:d});let c;try{c=await F(n,m);}catch(y){return a("withdraw-onchain",g(y),{titleTransactionID:d})}let u=await H(e,d,c);return u.ok?{ok:true,onChainTxHash:c,data:o.data}:u}async function v(t){let{client:e,clients:n,itemID:r,networkID:s,walletAddress:i,amount:l,category:p}=t,o=await e.blockchain.requestNFTWithdrawal(r,s,i,l,p);if(!o.ok)return a("request",o.error);let m=o.data.EvmSignature,d=o.data.TitleTransactionID??void 0;if(!m)return a("request","Withdrawal response carried no EVM signature.",{titleTransactionID:d});let c;try{c=await M(n,m);}catch(y){return a("withdraw-onchain",g(y),{titleTransactionID:d})}let u=await H(e,d,c);return u.ok?{ok:true,onChainTxHash:c,data:o.data}:u}async function H(t,e,n){if(!e)return a("confirm","Missing TitleTransactionID.",{onChainTxHash:n});let r=await t.blockchain.confirmWithdrawal(e,n);return r.ok?{ok:true,onChainTxHash:n,data:r.data}:a("confirm",r.error,{onChainTxHash:n,titleTransactionID:e})}async function A(t){let{client:e,clients:n,networkID:r}=t,s=t.walletAddress??n.account,i=await e.auth.requestWalletChallenge(s,r);if(!i.ok)return f("challenge",i.error);let l;try{l=await n.walletClient.signMessage({account:n.account,message:i.data.Message});}catch(o){return f("sign",g(o))}let p=await e.auth.loginWithWallet(s,r,l);return p.ok?{ok:true,data:p.data}:f("login",p.error)}function L(){let{address:t}=wagmi.useAccount(),e=wagmi.usePublicClient(),{data:n}=wagmi.useWalletClient();return !t||!e||!n?null:{account:t,publicClient:e,walletClient:n}}var h="Wallet not connected.";function oe(t,e){let n=L();return {connected:!!n,account:n?.account??null,loginWithWallet:(r,s)=>n?A({client:t,clients:n,networkID:r,walletAddress:s}):Promise.resolve(f("challenge",h)),depositToken:r=>n?T({client:t,clients:n,titleID:e,...r}):Promise.resolve(a("approve",h)),depositNft:r=>n?C({client:t,clients:n,titleID:e,...r}):Promise.resolve(a("deposit-onchain",h)),withdrawToken:r=>n?W({client:t,clients:n,...r}):Promise.resolve(a("withdraw-onchain",h)),withdrawNft:r=>n?v({client:t,clients:n,...r}):Promise.resolve(a("withdraw-onchain",h))}}function le(t){let{endpoint:e,wallets:n,autoConnect:r=true,children:s}=t;return jsxRuntime.jsx(walletAdapterReact.ConnectionProvider,{endpoint:e,children:jsxRuntime.jsx(walletAdapterReact.WalletProvider,{wallets:n,autoConnect:r,children:s})})}async function b(t){let{client:e,adapter:n,network:r,mint:s,amountRaw:i,titleID:l,category:p}=t,o=e.auth.context?.userID;if(!o)return a("deposit-onchain","Not logged in.");if(i<=0n)return a("deposit-onchain","Amount must be positive.");let m;try{m=await n.depositSpl({mint:s,amountRaw:i,userID:o,titleID:l,category:core.normalizeBlockchainCategory(p)});}catch(c){return a("deposit-onchain",g(c))}let d=await e.blockchain.depositToken(r.NetworkID??"",m);return d.ok?{ok:true,onChainTxHash:m,data:d.data}:a("report",d.error,{onChainTxHash:m})}async function P(t){let{client:e,adapter:n,currencyID:r,networkID:s,walletAddress:i,amount:l,category:p}=t,o=await e.blockchain.requestTokenWithdrawal(r,s,i,l,p);if(!o.ok)return a("request",o.error);let m=o.data.SolanaSignature,d=o.data.TitleTransactionID??void 0;if(!m)return a("request","Withdrawal response carried no Solana signature.",{titleTransactionID:d});let c;try{c=await n.submitWithdrawal(m);}catch(y){return a("withdraw-onchain",g(y),{titleTransactionID:d})}if(!d)return a("confirm","Missing TitleTransactionID.",{onChainTxHash:c});let u=await e.blockchain.confirmWithdrawal(d,c);return u.ok?{ok:true,onChainTxHash:c,data:o.data}:a("confirm",u.error,{onChainTxHash:c,titleTransactionID:d})}async function x(t){let{client:e,networkID:n,walletAddress:r,signMessage:s}=t,i=await e.auth.requestWalletChallenge(r,n);if(!i.ok)return f("challenge",i.error);let l;try{let o=await s(new TextEncoder().encode(i.data.Message));l=pe(o);}catch(o){return f("sign",g(o))}let p=await e.auth.loginWithWallet(r,n,l);return p.ok?{ok:true,data:p.data}:f("login",p.error)}function pe(t){let e="0x";for(let n of t)e+=n.toString(16).padStart(2,"0");return e}var O="Wallet not connected.";function me(t,e,n){let{publicKey:r,signMessage:s}=walletAdapterReact.useWallet(),i=r?.toBase58()??null;return {connected:!!i,account:i,loginWithWallet:(l,p)=>{let o=p??i;return o?s?x({client:t,networkID:l,walletAddress:o,signMessage:s}):Promise.resolve(f("sign","The connected wallet does not support message signing.")):Promise.resolve(f("challenge",O))},depositToken:l=>b({client:t,adapter:n,titleID:e,...l}),withdrawToken:l=>{let p=l.walletAddress??i;return p?P({client:t,adapter:n,...l,walletAddress:p}):Promise.resolve(a("request",O))}}}exports.IDosGamesWalletProvider=Y;exports.SolanaWalletBridgeProvider=le;exports.createEvmWalletConfig=_;exports.useEvmBridge=oe;exports.useEvmBridgeClients=L;exports.useSolanaBridge=me;

package/dist/react/index.d.cts

@@ -0,0 +1,150 @@
+import * as wagmi from 'wagmi';
+import { CreateConnectorFn, Config } from 'wagmi';
+import { Chain, Transport } from 'viem';
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { QueryClient } from '@tanstack/react-query';
+import { ClientState, DepositTokenResponse, DepositNFTResponse, TokenWithdrawalResponse, NFTWithdrawalResponse, IDosGamesClient } from '@idosgames/core';
+import { W as WalletLoginResult, e as DepositTokenEvmParams, a as BridgeResult, d as DepositNftEvmParams, k as WithdrawTokenEvmParams, j as WithdrawNftEvmParams, E as EvmBridgeClients, f as DepositTokenSolanaParams, l as WithdrawTokenSolanaParams, S as SolanaProgramAdapter } from '../bridge-BCxf6AHE.cjs';
+import { Adapter } from '@solana/wallet-adapter-base';
+
+interface EvmWalletConfigOptions {
+    /** Chains the game supports, matching the EVM networks in the title's blockchain config. */
+    chains: readonly [Chain, ...Chain[]];
+    /**
+     * WalletConnect Cloud project id — required to connect MOBILE wallets (and desktop wallets via
+     * QR). Get one at https://cloud.walletconnect.com. Omit to support browser-extension wallets only.
+     */
+    walletConnectProjectId?: string;
+    /** App name/metadata shown in the wallet's connect prompt. */
+    appName?: string;
+    appUrl?: string;
+    appIcon?: string;
+    /**
+     * Per-chain RPC transports. Defaults to `http()` (each chain's public RPC) for every chain —
+     * pass your own keyed by `chain.id` to use a private RPC endpoint.
+     */
+    transports?: Record<number, Transport>;
+    /**
+     * Override the connector list entirely. By default you get: `injected()` (MetaMask & other
+     * browser extensions), `walletConnect()` (mobile + QR, when a projectId is given), and
+     * `coinbaseWallet()`.
+     */
+    connectors?: CreateConnectorFn[];
+}
+/**
+ * Builds a wagmi `Config` wired for both browser and mobile wallets, ready to hand to
+ * {@link IDosGamesWalletProvider} (or a bare `WagmiProvider`).
+ *
+ * - Browser: `injected()` picks up MetaMask and any EIP-1193 extension.
+ * - Mobile: `walletConnect()` opens the WalletConnect modal (QR on desktop, deep-link on mobile)
+ *   so phone wallets like MetaMask Mobile, Trust, Rainbow can connect. Needs a `walletConnectProjectId`.
+ */
+declare function createEvmWalletConfig(options: EvmWalletConfigOptions): wagmi.Config<readonly [Chain, ...Chain[]], Record<number, Transport>, CreateConnectorFn[]>;
+
+interface IDosGamesWalletProviderProps {
+    /** A wagmi config, typically from {@link createEvmWalletConfig}. */
+    wagmiConfig: Config;
+    /** Reuse an existing react-query client; a fresh one is created if omitted. */
+    queryClient?: QueryClient;
+    children: ReactNode;
+}
+/**
+ * Drop-in provider that sets up the EVM wallet stack: `WagmiProvider` (connectors, chains) +
+ * `QueryClientProvider` (wagmi's required react-query dependency). Wrap your app once, then use the
+ * EVM hooks below anywhere inside. For Solana, additionally wrap with the wallet-adapter
+ * `ConnectionProvider` + `WalletProvider` from `@solana/wallet-adapter-react`.
+ *
+ * ```tsx
+ * const wagmiConfig = createEvmWalletConfig({ chains: [polygon], walletConnectProjectId: "…" });
+ * <IDosGamesWalletProvider wagmiConfig={wagmiConfig}>
+ *   <App />
+ * </IDosGamesWalletProvider>
+ * ```
+ */
+declare function IDosGamesWalletProvider(props: IDosGamesWalletProviderProps): react.JSX.Element;
+
+/**
+ * Assembles the viem clients the bridge needs from the connected wagmi wallet, or null when no
+ * wallet is connected / the wallet client isn't ready yet.
+ */
+declare function useEvmBridgeClients(): EvmBridgeClients | null;
+type DepositTokenArgs$1 = Omit<DepositTokenEvmParams, "client" | "clients" | "titleID">;
+type DepositNftArgs = Omit<DepositNftEvmParams, "client" | "clients" | "titleID">;
+type WithdrawTokenArgs$1 = Omit<WithdrawTokenEvmParams, "client" | "clients">;
+type WithdrawNftArgs = Omit<WithdrawNftEvmParams, "client" | "clients">;
+interface EvmBridge {
+    /** Whether a wallet is connected and its client is ready. */
+    connected: boolean;
+    /** The connected signing address, or null. */
+    account: string | null;
+    /**
+     * Logs into the game with the connected wallet by signing a server challenge (no gas, no tx).
+     * `networkID` is the cfg.Blockchain.Networks key the wallet proves on; `walletAddress` defaults
+     * to the connected account. On success the core client is logged in and its ClientState returned.
+     */
+    loginWithWallet(networkID: string, walletAddress?: string): Promise<WalletLoginResult<ClientState>>;
+    depositToken(args: DepositTokenArgs$1): Promise<BridgeResult<DepositTokenResponse>>;
+    depositNft(args: DepositNftArgs): Promise<BridgeResult<DepositNFTResponse>>;
+    withdrawToken(args: WithdrawTokenArgs$1): Promise<BridgeResult<TokenWithdrawalResponse>>;
+    withdrawNft(args: WithdrawNftArgs): Promise<BridgeResult<NFTWithdrawalResponse>>;
+}
+/**
+ * The ergonomic EVM bridge hook: binds the connected wagmi wallet to the four deposit/withdraw
+ * flows against a given core client + title. Each method returns a {@link BridgeResult}; a
+ * disconnected wallet yields a `{ ok: false }` instead of throwing.
+ *
+ * ```tsx
+ * const bridge = useEvmBridge(client, "my-title");
+ * const res = await bridge.depositToken({ network, tokenAddress, amount: parseUnits("25", 6) });
+ * if (!res.ok) toast(res.error);
+ * ```
+ */
+declare function useEvmBridge(client: IDosGamesClient, titleID: string): EvmBridge;
+
+interface SolanaWalletBridgeProviderProps {
+    /** RPC endpoint for the Solana network the title uses (matches its blockchain config). */
+    endpoint: string;
+    /**
+     * Wallet adapters to offer (e.g. `new PhantomWalletAdapter()` from
+     * `@solana/wallet-adapter-wallets`). Mobile support comes from adapters that implement it
+     * (Mobile Wallet Adapter on Android, or a WalletConnect adapter).
+     */
+    wallets: Adapter[];
+    /** Auto-reconnect the last-used wallet on mount. */
+    autoConnect?: boolean;
+    children: ReactNode;
+}
+/**
+ * Thin wrapper over wallet-adapter's `ConnectionProvider` + `WalletProvider` so the
+ * {@link useSolanaBridge} hook has a connected wallet. Compose it alongside
+ * {@link IDosGamesWalletProvider} when a title supports both EVM and Solana networks.
+ */
+declare function SolanaWalletBridgeProvider(props: SolanaWalletBridgeProviderProps): react.JSX.Element;
+
+type DepositTokenArgs = Omit<DepositTokenSolanaParams, "client" | "adapter" | "titleID">;
+/** `walletAddress` defaults to the connected wallet if omitted. */
+type WithdrawTokenArgs = Omit<WithdrawTokenSolanaParams, "client" | "adapter" | "walletAddress"> & {
+    walletAddress?: string;
+};
+interface SolanaBridge {
+    connected: boolean;
+    account: string | null;
+    /**
+     * Logs into the game with the connected Solana wallet by signing a server challenge (no tx, no
+     * fee). `networkID` is the cfg.Blockchain.Networks key; `walletAddress` defaults to the connected
+     * account. Requires a wallet that supports `signMessage`. Returns the fresh ClientState.
+     */
+    loginWithWallet(networkID: string, walletAddress?: string): Promise<WalletLoginResult<ClientState>>;
+    depositToken(args: DepositTokenArgs): Promise<BridgeResult<DepositTokenResponse>>;
+    withdrawToken(args: WithdrawTokenArgs): Promise<BridgeResult<TokenWithdrawalResponse>>;
+}
+/**
+ * The ergonomic Solana bridge hook: binds the connected wallet-adapter wallet + your
+ * {@link SolanaProgramAdapter} to the deposit/withdraw flows against a core client + title.
+ * The on-chain instruction building lives in the adapter (it owns the program IDL); this hook
+ * just wires the connected address and threads the request → submit → confirm lifecycle.
+ */
+declare function useSolanaBridge(client: IDosGamesClient, titleID: string, adapter: SolanaProgramAdapter): SolanaBridge;
+
+export { type EvmBridge, type EvmWalletConfigOptions, IDosGamesWalletProvider, type IDosGamesWalletProviderProps, type SolanaBridge, SolanaWalletBridgeProvider, type SolanaWalletBridgeProviderProps, createEvmWalletConfig, useEvmBridge, useEvmBridgeClients, useSolanaBridge };

package/dist/react/index.d.ts

@@ -0,0 +1,150 @@
+import * as wagmi from 'wagmi';
+import { CreateConnectorFn, Config } from 'wagmi';
+import { Chain, Transport } from 'viem';
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { QueryClient } from '@tanstack/react-query';
+import { ClientState, DepositTokenResponse, DepositNFTResponse, TokenWithdrawalResponse, NFTWithdrawalResponse, IDosGamesClient } from '@idosgames/core';
+import { W as WalletLoginResult, e as DepositTokenEvmParams, a as BridgeResult, d as DepositNftEvmParams, k as WithdrawTokenEvmParams, j as WithdrawNftEvmParams, E as EvmBridgeClients, f as DepositTokenSolanaParams, l as WithdrawTokenSolanaParams, S as SolanaProgramAdapter } from '../bridge-BCxf6AHE.js';
+import { Adapter } from '@solana/wallet-adapter-base';
+
+interface EvmWalletConfigOptions {
+    /** Chains the game supports, matching the EVM networks in the title's blockchain config. */
+    chains: readonly [Chain, ...Chain[]];
+    /**
+     * WalletConnect Cloud project id — required to connect MOBILE wallets (and desktop wallets via
+     * QR). Get one at https://cloud.walletconnect.com. Omit to support browser-extension wallets only.
+     */
+    walletConnectProjectId?: string;
+    /** App name/metadata shown in the wallet's connect prompt. */
+    appName?: string;
+    appUrl?: string;
+    appIcon?: string;
+    /**
+     * Per-chain RPC transports. Defaults to `http()` (each chain's public RPC) for every chain —
+     * pass your own keyed by `chain.id` to use a private RPC endpoint.
+     */
+    transports?: Record<number, Transport>;
+    /**
+     * Override the connector list entirely. By default you get: `injected()` (MetaMask & other
+     * browser extensions), `walletConnect()` (mobile + QR, when a projectId is given), and
+     * `coinbaseWallet()`.
+     */
+    connectors?: CreateConnectorFn[];
+}
+/**
+ * Builds a wagmi `Config` wired for both browser and mobile wallets, ready to hand to
+ * {@link IDosGamesWalletProvider} (or a bare `WagmiProvider`).
+ *
+ * - Browser: `injected()` picks up MetaMask and any EIP-1193 extension.
+ * - Mobile: `walletConnect()` opens the WalletConnect modal (QR on desktop, deep-link on mobile)
+ *   so phone wallets like MetaMask Mobile, Trust, Rainbow can connect. Needs a `walletConnectProjectId`.
+ */
+declare function createEvmWalletConfig(options: EvmWalletConfigOptions): wagmi.Config<readonly [Chain, ...Chain[]], Record<number, Transport>, CreateConnectorFn[]>;
+
+interface IDosGamesWalletProviderProps {
+    /** A wagmi config, typically from {@link createEvmWalletConfig}. */
+    wagmiConfig: Config;
+    /** Reuse an existing react-query client; a fresh one is created if omitted. */
+    queryClient?: QueryClient;
+    children: ReactNode;
+}
+/**
+ * Drop-in provider that sets up the EVM wallet stack: `WagmiProvider` (connectors, chains) +
+ * `QueryClientProvider` (wagmi's required react-query dependency). Wrap your app once, then use the
+ * EVM hooks below anywhere inside. For Solana, additionally wrap with the wallet-adapter
+ * `ConnectionProvider` + `WalletProvider` from `@solana/wallet-adapter-react`.
+ *
+ * ```tsx
+ * const wagmiConfig = createEvmWalletConfig({ chains: [polygon], walletConnectProjectId: "…" });
+ * <IDosGamesWalletProvider wagmiConfig={wagmiConfig}>
+ *   <App />
+ * </IDosGamesWalletProvider>
+ * ```
+ */
+declare function IDosGamesWalletProvider(props: IDosGamesWalletProviderProps): react.JSX.Element;
+
+/**
+ * Assembles the viem clients the bridge needs from the connected wagmi wallet, or null when no
+ * wallet is connected / the wallet client isn't ready yet.
+ */
+declare function useEvmBridgeClients(): EvmBridgeClients | null;
+type DepositTokenArgs$1 = Omit<DepositTokenEvmParams, "client" | "clients" | "titleID">;
+type DepositNftArgs = Omit<DepositNftEvmParams, "client" | "clients" | "titleID">;
+type WithdrawTokenArgs$1 = Omit<WithdrawTokenEvmParams, "client" | "clients">;
+type WithdrawNftArgs = Omit<WithdrawNftEvmParams, "client" | "clients">;
+interface EvmBridge {
+    /** Whether a wallet is connected and its client is ready. */
+    connected: boolean;
+    /** The connected signing address, or null. */
+    account: string | null;
+    /**
+     * Logs into the game with the connected wallet by signing a server challenge (no gas, no tx).
+     * `networkID` is the cfg.Blockchain.Networks key the wallet proves on; `walletAddress` defaults
+     * to the connected account. On success the core client is logged in and its ClientState returned.
+     */
+    loginWithWallet(networkID: string, walletAddress?: string): Promise<WalletLoginResult<ClientState>>;
+    depositToken(args: DepositTokenArgs$1): Promise<BridgeResult<DepositTokenResponse>>;
+    depositNft(args: DepositNftArgs): Promise<BridgeResult<DepositNFTResponse>>;
+    withdrawToken(args: WithdrawTokenArgs$1): Promise<BridgeResult<TokenWithdrawalResponse>>;
+    withdrawNft(args: WithdrawNftArgs): Promise<BridgeResult<NFTWithdrawalResponse>>;
+}
+/**
+ * The ergonomic EVM bridge hook: binds the connected wagmi wallet to the four deposit/withdraw
+ * flows against a given core client + title. Each method returns a {@link BridgeResult}; a
+ * disconnected wallet yields a `{ ok: false }` instead of throwing.
+ *
+ * ```tsx
+ * const bridge = useEvmBridge(client, "my-title");
+ * const res = await bridge.depositToken({ network, tokenAddress, amount: parseUnits("25", 6) });
+ * if (!res.ok) toast(res.error);
+ * ```
+ */
+declare function useEvmBridge(client: IDosGamesClient, titleID: string): EvmBridge;
+
+interface SolanaWalletBridgeProviderProps {
+    /** RPC endpoint for the Solana network the title uses (matches its blockchain config). */
+    endpoint: string;
+    /**
+     * Wallet adapters to offer (e.g. `new PhantomWalletAdapter()` from
+     * `@solana/wallet-adapter-wallets`). Mobile support comes from adapters that implement it
+     * (Mobile Wallet Adapter on Android, or a WalletConnect adapter).
+     */
+    wallets: Adapter[];
+    /** Auto-reconnect the last-used wallet on mount. */
+    autoConnect?: boolean;
+    children: ReactNode;
+}
+/**
+ * Thin wrapper over wallet-adapter's `ConnectionProvider` + `WalletProvider` so the
+ * {@link useSolanaBridge} hook has a connected wallet. Compose it alongside
+ * {@link IDosGamesWalletProvider} when a title supports both EVM and Solana networks.
+ */
+declare function SolanaWalletBridgeProvider(props: SolanaWalletBridgeProviderProps): react.JSX.Element;
+
+type DepositTokenArgs = Omit<DepositTokenSolanaParams, "client" | "adapter" | "titleID">;
+/** `walletAddress` defaults to the connected wallet if omitted. */
+type WithdrawTokenArgs = Omit<WithdrawTokenSolanaParams, "client" | "adapter" | "walletAddress"> & {
+    walletAddress?: string;
+};
+interface SolanaBridge {
+    connected: boolean;
+    account: string | null;
+    /**
+     * Logs into the game with the connected Solana wallet by signing a server challenge (no tx, no
+     * fee). `networkID` is the cfg.Blockchain.Networks key; `walletAddress` defaults to the connected
+     * account. Requires a wallet that supports `signMessage`. Returns the fresh ClientState.
+     */
+    loginWithWallet(networkID: string, walletAddress?: string): Promise<WalletLoginResult<ClientState>>;
+    depositToken(args: DepositTokenArgs): Promise<BridgeResult<DepositTokenResponse>>;
+    withdrawToken(args: WithdrawTokenArgs): Promise<BridgeResult<TokenWithdrawalResponse>>;
+}
+/**
+ * The ergonomic Solana bridge hook: binds the connected wallet-adapter wallet + your
+ * {@link SolanaProgramAdapter} to the deposit/withdraw flows against a core client + title.
+ * The on-chain instruction building lives in the adapter (it owns the program IDL); this hook
+ * just wires the connected address and threads the request → submit → confirm lifecycle.
+ */
+declare function useSolanaBridge(client: IDosGamesClient, titleID: string, adapter: SolanaProgramAdapter): SolanaBridge;
+
+export { type EvmBridge, type EvmWalletConfigOptions, IDosGamesWalletProvider, type IDosGamesWalletProviderProps, type SolanaBridge, SolanaWalletBridgeProvider, type SolanaWalletBridgeProviderProps, createEvmWalletConfig, useEvmBridge, useEvmBridgeClients, useSolanaBridge };