@tuwaio/orbit-solana 0.2.0 → 0.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.mts +19 -1
- package/dist/index.d.ts +19 -1
- package/dist/index.js +2 -3
- package/dist/index.mjs +2 -3
- package/package.json +2 -2
- package/dist/index.js.map +0 -1
- package/dist/index.mjs.map +0 -1
package/dist/index.d.mts
CHANGED
|
@@ -1,10 +1,28 @@
|
|
|
1
1
|
import { SolanaClusterMoniker, SolanaClient, Rpc, SolanaRpcApi } from 'gill';
|
|
2
|
+
import { ChainIdentifierArray } from '@tuwaio/orbit-core';
|
|
2
3
|
import * as _wallet_standard_ui_core from '@wallet-standard/ui-core';
|
|
3
4
|
|
|
4
5
|
type SolanaRPCUrls = {
|
|
5
6
|
rpcUrls: Partial<Record<SolanaClusterMoniker, string>>;
|
|
6
7
|
};
|
|
7
8
|
|
|
9
|
+
/**
|
|
10
|
+
* Get Solana clusters from configuration
|
|
11
|
+
*/
|
|
12
|
+
declare function getSolanaClusters(solanaRPCUrls?: Partial<Record<SolanaClusterMoniker, string>>, chains?: ChainIdentifierArray): string[];
|
|
13
|
+
/**
|
|
14
|
+
* Type guard to check if a chain list contains Solana cluster names
|
|
15
|
+
*/
|
|
16
|
+
declare function isSolanaChainList(chains: (string | number)[]): chains is string[];
|
|
17
|
+
/**
|
|
18
|
+
* Gets available Solana clusters from the default configuration
|
|
19
|
+
*/
|
|
20
|
+
declare function getAvailableSolanaClusters(): SolanaClusterMoniker[];
|
|
21
|
+
/**
|
|
22
|
+
* Validates if a string is a valid Solana cluster moniker
|
|
23
|
+
*/
|
|
24
|
+
declare function isValidSolanaCluster(cluster: string): boolean;
|
|
25
|
+
|
|
8
26
|
/**
|
|
9
27
|
* Safely extracts the cluster moniker from a chain identifier.
|
|
10
28
|
* Handles both full chain IDs ('solana:mainnet-beta') and simple monikers ('mainnet-beta').
|
|
@@ -143,4 +161,4 @@ declare const getSolanaNameCacheSize: () => number;
|
|
|
143
161
|
*/
|
|
144
162
|
declare const getSolanaExplorerLink: (url?: string, chainId?: string | number | undefined) => string;
|
|
145
163
|
|
|
146
|
-
export { type SolanaRPCUrls, clearSolanaAvatarCache, clearSolanaNameCache, createSolanaClientWithCache, createSolanaRPC, defaultRpcUrlsByMoniker, getAvailableSolanaConnectors, getCluster, getConnectedSolanaConnector, getRpcUrlForCluster, getSolanaAddressAvatar, getSolanaAddressName, getSolanaAvatarCacheSize, getSolanaExplorerLink, getSolanaNameCacheSize, preloadSolanaAvatar };
|
|
164
|
+
export { type SolanaRPCUrls, clearSolanaAvatarCache, clearSolanaNameCache, createSolanaClientWithCache, createSolanaRPC, defaultRpcUrlsByMoniker, getAvailableSolanaClusters, getAvailableSolanaConnectors, getCluster, getConnectedSolanaConnector, getRpcUrlForCluster, getSolanaAddressAvatar, getSolanaAddressName, getSolanaAvatarCacheSize, getSolanaClusters, getSolanaExplorerLink, getSolanaNameCacheSize, isSolanaChainList, isValidSolanaCluster, preloadSolanaAvatar };
|
package/dist/index.d.ts
CHANGED
|
@@ -1,10 +1,28 @@
|
|
|
1
1
|
import { SolanaClusterMoniker, SolanaClient, Rpc, SolanaRpcApi } from 'gill';
|
|
2
|
+
import { ChainIdentifierArray } from '@tuwaio/orbit-core';
|
|
2
3
|
import * as _wallet_standard_ui_core from '@wallet-standard/ui-core';
|
|
3
4
|
|
|
4
5
|
type SolanaRPCUrls = {
|
|
5
6
|
rpcUrls: Partial<Record<SolanaClusterMoniker, string>>;
|
|
6
7
|
};
|
|
7
8
|
|
|
9
|
+
/**
|
|
10
|
+
* Get Solana clusters from configuration
|
|
11
|
+
*/
|
|
12
|
+
declare function getSolanaClusters(solanaRPCUrls?: Partial<Record<SolanaClusterMoniker, string>>, chains?: ChainIdentifierArray): string[];
|
|
13
|
+
/**
|
|
14
|
+
* Type guard to check if a chain list contains Solana cluster names
|
|
15
|
+
*/
|
|
16
|
+
declare function isSolanaChainList(chains: (string | number)[]): chains is string[];
|
|
17
|
+
/**
|
|
18
|
+
* Gets available Solana clusters from the default configuration
|
|
19
|
+
*/
|
|
20
|
+
declare function getAvailableSolanaClusters(): SolanaClusterMoniker[];
|
|
21
|
+
/**
|
|
22
|
+
* Validates if a string is a valid Solana cluster moniker
|
|
23
|
+
*/
|
|
24
|
+
declare function isValidSolanaCluster(cluster: string): boolean;
|
|
25
|
+
|
|
8
26
|
/**
|
|
9
27
|
* Safely extracts the cluster moniker from a chain identifier.
|
|
10
28
|
* Handles both full chain IDs ('solana:mainnet-beta') and simple monikers ('mainnet-beta').
|
|
@@ -143,4 +161,4 @@ declare const getSolanaNameCacheSize: () => number;
|
|
|
143
161
|
*/
|
|
144
162
|
declare const getSolanaExplorerLink: (url?: string, chainId?: string | number | undefined) => string;
|
|
145
163
|
|
|
146
|
-
export { type SolanaRPCUrls, clearSolanaAvatarCache, clearSolanaNameCache, createSolanaClientWithCache, createSolanaRPC, defaultRpcUrlsByMoniker, getAvailableSolanaConnectors, getCluster, getConnectedSolanaConnector, getRpcUrlForCluster, getSolanaAddressAvatar, getSolanaAddressName, getSolanaAvatarCacheSize, getSolanaExplorerLink, getSolanaNameCacheSize, preloadSolanaAvatar };
|
|
164
|
+
export { type SolanaRPCUrls, clearSolanaAvatarCache, clearSolanaNameCache, createSolanaClientWithCache, createSolanaRPC, defaultRpcUrlsByMoniker, getAvailableSolanaClusters, getAvailableSolanaConnectors, getCluster, getConnectedSolanaConnector, getRpcUrlForCluster, getSolanaAddressAvatar, getSolanaAddressName, getSolanaAvatarCacheSize, getSolanaClusters, getSolanaExplorerLink, getSolanaNameCacheSize, isSolanaChainList, isValidSolanaCluster, preloadSolanaAvatar };
|
package/dist/index.js
CHANGED
|
@@ -1,3 +1,2 @@
|
|
|
1
|
-
'use strict';var gill=require('gill'),orbitCore=require('@tuwaio/orbit-core'),app=require('@wallet-standard/app'),uiRegistry=require('@wallet-standard/ui-registry');var f=({cluster:t,walletCluster:e})=>{let r="mainnet";return t?t.includes(":")?t.split(":")[1]:t:e??r},
|
|
2
|
-
exports.clearSolanaAvatarCache=
|
|
3
|
-
//# sourceMappingURL=index.js.map
|
|
1
|
+
'use strict';var gill=require('gill'),orbitCore=require('@tuwaio/orbit-core'),app=require('@wallet-standard/app'),uiRegistry=require('@wallet-standard/ui-registry');var o={mainnet:"https://api.mainnet-beta.solana.com",devnet:"https://api.devnet.solana.com",testnet:"https://api.testnet.solana.com"};function d(t){let e=t.split(":");if(e.length<2)return null;let r=e[1];r==="mainnet-beta"&&(r="mainnet");let n=r;return n in o?n:null}function S(t,e){let r={},n=Object.keys(e||o);for(let a of t){if(typeof a!="string")continue;let s=d(a);if(!s||!n.includes(s))continue;let f=e?.[s]??o[s];f&&(r[s]=f);}return r}function F(t,e){if(e&&e.length>0){let r=S(e,t);return Object.keys(r)}return Object.keys(t||o)}function z(t){return t.length>0&&t.every(e=>typeof e=="string")}function B(){return Object.keys(o)}function j(t){return t in o}var m=({cluster:t,walletCluster:e})=>{let r="mainnet";return t?t.includes(":")?t.split(":")[1]:t:e??r},T=({cluster:t,walletCluster:e,rpcUrls:r})=>r[e??t]??"https://api.mainnet-beta.solana.com/";function h(t){try{return new URL(t),!0}catch{return false}}var u=new Map,Z=({rpcUrlOrMoniker:t,rpcUrls:e})=>{if(u.has(t))return u.get(t);let r=h(t)?t:e?e[t]??o[t]:o[t];if(!r)throw new Error(`Unable to resolve RPC URL for input: "${t}". Ensure it's a valid URL or known moniker.`);let n=gill.createSolanaClient({urlOrMoniker:r});return u.set(t,n),n};function R(t){try{return new URL(t),!0}catch{return false}}var p=new Map,tt=({rpcUrlOrMoniker:t,rpcUrls:e})=>{if(p.has(t))return p.get(t);let r=R(t)?t:e?e[t]??o[t]:o[t];if(!r)throw new Error(`Unable to resolve RPC URL for input: "${t}". Ensure it's a valid URL or known moniker.`);let n=gill.createSolanaRpc(r);return p.set(t,n),n};function g(){return orbitCore.filterUniqueByKey(app.getWallets().get().map(uiRegistry.getOrCreateUiWalletForStandardWallet_DO_NOT_USE_OR_YOU_WILL_BE_FIRED),"name").filter(t=>{try{return !t||!Array.isArray(t.chains)||!t.features||!Array.isArray(t.features)||!["standard:connect","standard:disconnect","standard:events","solana:signAndSendTransaction","solana:signTransaction","solana:signMessage"].every(n=>t.features.includes(n))?!1:t.chains.every(n=>{try{if(typeof n!="string")return !1;let a=n.split(":");return a.length>=1&&a[0]==="solana"}catch(a){return console.warn("Error parsing chain:",n,a),!1}})}catch(e){return console.warn("Error filtering wallet:",e),false}})}function lt(){let t=orbitCore.lastConnectedConnectorHelpers.getLastConnectedConnector(),r=g().find(n=>n.accounts.find(a=>a.address.toLowerCase()===t?.address?.toLowerCase()));if(!r)throw new Error("Connector not provided. Cannot perform chain check.");return r}var l=new Map,b="https://image-api.bonfida.com",k=t=>/^[1-9A-HJ-NP-Za-km-z]{32,44}$/.test(t),U=t=>/^[a-z0-9-]+\.sol$/.test(t.toLowerCase()),N=async t=>{try{let e=await fetch(`${b}/image?domain=${encodeURIComponent(t)}`);if(!e.ok)return null;let r=await e.json();return r.result&&Array.isArray(r.result)&&r.result.length>0?r.result.find(a=>a.domain===t)?.image??r.result[0]?.image??null:null}catch(e){return console.warn("Failed to fetch SNS avatar:",e),null}},i=t=>`https://api.dicebear.com/7.x/identicon/svg?seed=${encodeURIComponent(t)}`,P=async t=>{if(!t)return i("default");let e=t.trim();if(!e)return i("default");let r=e.toLowerCase(),n=l.get(r);if(n!==void 0)return n;let a;try{if(U(e)){let s=await N(e);s?a=s:a=i(e);}else k(e),a=i(e);}catch(s){console.warn("Error resolving avatar:",s),a=i(e);}return l.set(r,a),a},ut=()=>{l.clear();},pt=()=>l.size,ft=async t=>{try{await P(t);}catch(e){console.warn("Failed to preload avatar:",e);}};var c=new Map,L="https://sns-api.bonfida.com",M=async t=>{try{let e=await fetch(`${L}/v2/user/fav-domains/${t}`);if(!e.ok)return null;let r=await e.json();return r.result&&typeof r.result=="object"&&t in r.result?r.result[t]:null}catch(e){return console.warn("Failed to fetch SNS name:",e),null}},E=t=>/^[1-9A-HJ-NP-Za-km-z]{32,44}$/.test(t),gt=async t=>{if(!t)return t||"";if(!E(t.trim()))return t;let e=t.toLowerCase().trim(),r=c.get(e);if(r!==void 0)return r;let n=t;try{let a=await M(t);a&&(n=a);}catch(a){console.warn("Error resolving address name:",a);}return c.set(e,n),n},dt=()=>{c.clear();},St=()=>c.size;var Rt=(t,e)=>{let r=m({cluster:String(e)})??"mainnet",n=gill.getExplorerLink(),a=n.endsWith("/")?n.slice(0,-1):n,s=r?`?cluster=${r}`:"";return `${a}${t||"/"}${s}`};
|
|
2
|
+
exports.clearSolanaAvatarCache=ut;exports.clearSolanaNameCache=dt;exports.createSolanaClientWithCache=Z;exports.createSolanaRPC=tt;exports.defaultRpcUrlsByMoniker=o;exports.getAvailableSolanaClusters=B;exports.getAvailableSolanaConnectors=g;exports.getCluster=m;exports.getConnectedSolanaConnector=lt;exports.getRpcUrlForCluster=T;exports.getSolanaAddressAvatar=P;exports.getSolanaAddressName=gt;exports.getSolanaAvatarCacheSize=pt;exports.getSolanaClusters=F;exports.getSolanaExplorerLink=Rt;exports.getSolanaNameCacheSize=St;exports.isSolanaChainList=z;exports.isValidSolanaCluster=j;exports.preloadSolanaAvatar=ft;
|
package/dist/index.mjs
CHANGED
|
@@ -1,3 +1,2 @@
|
|
|
1
|
-
import {createSolanaClient,createSolanaRpc,getExplorerLink}from'gill';import {filterUniqueByKey,lastConnectedConnectorHelpers}from'@tuwaio/orbit-core';import {getWallets}from'@wallet-standard/app';import {getOrCreateUiWalletForStandardWallet_DO_NOT_USE_OR_YOU_WILL_BE_FIRED}from'@wallet-standard/ui-registry';var f=({cluster:t,walletCluster:e})=>{let r="mainnet";return t?t.includes(":")?t.split(":")[1]:t:e??r},
|
|
2
|
-
export{
|
|
3
|
-
//# sourceMappingURL=index.mjs.map
|
|
1
|
+
import {createSolanaClient,createSolanaRpc,getExplorerLink}from'gill';import {filterUniqueByKey,lastConnectedConnectorHelpers}from'@tuwaio/orbit-core';import {getWallets}from'@wallet-standard/app';import {getOrCreateUiWalletForStandardWallet_DO_NOT_USE_OR_YOU_WILL_BE_FIRED}from'@wallet-standard/ui-registry';var o={mainnet:"https://api.mainnet-beta.solana.com",devnet:"https://api.devnet.solana.com",testnet:"https://api.testnet.solana.com"};function d(t){let e=t.split(":");if(e.length<2)return null;let r=e[1];r==="mainnet-beta"&&(r="mainnet");let n=r;return n in o?n:null}function S(t,e){let r={},n=Object.keys(e||o);for(let a of t){if(typeof a!="string")continue;let s=d(a);if(!s||!n.includes(s))continue;let f=e?.[s]??o[s];f&&(r[s]=f);}return r}function F(t,e){if(e&&e.length>0){let r=S(e,t);return Object.keys(r)}return Object.keys(t||o)}function z(t){return t.length>0&&t.every(e=>typeof e=="string")}function B(){return Object.keys(o)}function j(t){return t in o}var m=({cluster:t,walletCluster:e})=>{let r="mainnet";return t?t.includes(":")?t.split(":")[1]:t:e??r},T=({cluster:t,walletCluster:e,rpcUrls:r})=>r[e??t]??"https://api.mainnet-beta.solana.com/";function h(t){try{return new URL(t),!0}catch{return false}}var u=new Map,Z=({rpcUrlOrMoniker:t,rpcUrls:e})=>{if(u.has(t))return u.get(t);let r=h(t)?t:e?e[t]??o[t]:o[t];if(!r)throw new Error(`Unable to resolve RPC URL for input: "${t}". Ensure it's a valid URL or known moniker.`);let n=createSolanaClient({urlOrMoniker:r});return u.set(t,n),n};function R(t){try{return new URL(t),!0}catch{return false}}var p=new Map,tt=({rpcUrlOrMoniker:t,rpcUrls:e})=>{if(p.has(t))return p.get(t);let r=R(t)?t:e?e[t]??o[t]:o[t];if(!r)throw new Error(`Unable to resolve RPC URL for input: "${t}". Ensure it's a valid URL or known moniker.`);let n=createSolanaRpc(r);return p.set(t,n),n};function g(){return filterUniqueByKey(getWallets().get().map(getOrCreateUiWalletForStandardWallet_DO_NOT_USE_OR_YOU_WILL_BE_FIRED),"name").filter(t=>{try{return !t||!Array.isArray(t.chains)||!t.features||!Array.isArray(t.features)||!["standard:connect","standard:disconnect","standard:events","solana:signAndSendTransaction","solana:signTransaction","solana:signMessage"].every(n=>t.features.includes(n))?!1:t.chains.every(n=>{try{if(typeof n!="string")return !1;let a=n.split(":");return a.length>=1&&a[0]==="solana"}catch(a){return console.warn("Error parsing chain:",n,a),!1}})}catch(e){return console.warn("Error filtering wallet:",e),false}})}function lt(){let t=lastConnectedConnectorHelpers.getLastConnectedConnector(),r=g().find(n=>n.accounts.find(a=>a.address.toLowerCase()===t?.address?.toLowerCase()));if(!r)throw new Error("Connector not provided. Cannot perform chain check.");return r}var l=new Map,b="https://image-api.bonfida.com",k=t=>/^[1-9A-HJ-NP-Za-km-z]{32,44}$/.test(t),U=t=>/^[a-z0-9-]+\.sol$/.test(t.toLowerCase()),N=async t=>{try{let e=await fetch(`${b}/image?domain=${encodeURIComponent(t)}`);if(!e.ok)return null;let r=await e.json();return r.result&&Array.isArray(r.result)&&r.result.length>0?r.result.find(a=>a.domain===t)?.image??r.result[0]?.image??null:null}catch(e){return console.warn("Failed to fetch SNS avatar:",e),null}},i=t=>`https://api.dicebear.com/7.x/identicon/svg?seed=${encodeURIComponent(t)}`,P=async t=>{if(!t)return i("default");let e=t.trim();if(!e)return i("default");let r=e.toLowerCase(),n=l.get(r);if(n!==void 0)return n;let a;try{if(U(e)){let s=await N(e);s?a=s:a=i(e);}else k(e),a=i(e);}catch(s){console.warn("Error resolving avatar:",s),a=i(e);}return l.set(r,a),a},ut=()=>{l.clear();},pt=()=>l.size,ft=async t=>{try{await P(t);}catch(e){console.warn("Failed to preload avatar:",e);}};var c=new Map,L="https://sns-api.bonfida.com",M=async t=>{try{let e=await fetch(`${L}/v2/user/fav-domains/${t}`);if(!e.ok)return null;let r=await e.json();return r.result&&typeof r.result=="object"&&t in r.result?r.result[t]:null}catch(e){return console.warn("Failed to fetch SNS name:",e),null}},E=t=>/^[1-9A-HJ-NP-Za-km-z]{32,44}$/.test(t),gt=async t=>{if(!t)return t||"";if(!E(t.trim()))return t;let e=t.toLowerCase().trim(),r=c.get(e);if(r!==void 0)return r;let n=t;try{let a=await M(t);a&&(n=a);}catch(a){console.warn("Error resolving address name:",a);}return c.set(e,n),n},dt=()=>{c.clear();},St=()=>c.size;var Rt=(t,e)=>{let r=m({cluster:String(e)})??"mainnet",n=getExplorerLink(),a=n.endsWith("/")?n.slice(0,-1):n,s=r?`?cluster=${r}`:"";return `${a}${t||"/"}${s}`};
|
|
2
|
+
export{ut as clearSolanaAvatarCache,dt as clearSolanaNameCache,Z as createSolanaClientWithCache,tt as createSolanaRPC,o as defaultRpcUrlsByMoniker,B as getAvailableSolanaClusters,g as getAvailableSolanaConnectors,m as getCluster,lt as getConnectedSolanaConnector,T as getRpcUrlForCluster,P as getSolanaAddressAvatar,gt as getSolanaAddressName,pt as getSolanaAvatarCacheSize,F as getSolanaClusters,Rt as getSolanaExplorerLink,St as getSolanaNameCacheSize,z as isSolanaChainList,j as isValidSolanaCluster,ft as preloadSolanaAvatar};
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tuwaio/orbit-solana",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.2",
|
|
4
4
|
"private": false,
|
|
5
5
|
"author": "Oleksandr Tkach",
|
|
6
6
|
"license": "Apache-2.0",
|
|
@@ -49,7 +49,7 @@
|
|
|
49
49
|
"@wallet-standard/app": "^1.1.0",
|
|
50
50
|
"@wallet-standard/ui-core": "^1.0.0",
|
|
51
51
|
"@wallet-standard/ui-registry": "^1.0.1",
|
|
52
|
-
"@tuwaio/orbit-core": "^0.2.
|
|
52
|
+
"@tuwaio/orbit-core": "^0.2.2"
|
|
53
53
|
},
|
|
54
54
|
"scripts": {
|
|
55
55
|
"start": "tsup src/index.ts --watch",
|
package/dist/index.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/utils/clusterHelpers.ts","../src/utils/defaultRpcUrlsByMoniker.ts","../src/utils/createSolanaClientWithCache.ts","../src/utils/createSolanaRPC.ts","../src/utils/getAvailableSolanaConnectors.ts","../src/utils/getConnectedSolanaConnector.ts","../src/utils/getSolanaAddressAvatar.ts","../src/utils/getSolanaAddressName.ts","../src/utils/getSolanaExplorerLink.ts"],"names":["getCluster","cluster","walletCluster","defaultCluster","getRpcUrlForCluster","rpcUrls","defaultRpcUrlsByMoniker","isValidUrl","str","clientsCache","createSolanaClientWithCache","rpcUrlOrMoniker","rpcUrl","newClient","createSolanaClient","rpcCache","createSolanaRPC","newRpc","createSolanaRpc","getAvailableSolanaConnectors","filterUniqueByKey","getWallets","getOrCreateUiWalletForStandardWallet","wallet","requiredFeature","chain","chainParts","error","getConnectedSolanaConnector","lastConnectedConnector","lastConnectedConnectorHelpers","connectedConnector","w","solanaAvatarCache","SNS_API_BASE_URL","isValidSolanaAddress","address","isValidSNSDomain","domain","getSNSAvatar","response","data","item","getDefaultAvatar","identifier","getSolanaAddressAvatar","addressOrDomain","trimmedInput","normalizedInput","cachedAvatar","resultAvatar","snsAvatar","clearSolanaAvatarCache","getSolanaAvatarCacheSize","preloadSolanaAvatar","solanaNameCache","getSNSName","getSolanaAddressName","normalizedAddress","cachedName","resultName","snsName","clearSolanaNameCache","getSolanaNameCacheSize","getSolanaExplorerLink","url","chainId","baseUrl","getExplorerLink","sanitizedBaseUrl","clusterParam"],"mappings":"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","file":"index.js","sourcesContent":["import type { SolanaClusterMoniker } from 'gill';\n\nimport { SolanaRPCUrls } from '../types';\n\n/**\n * Safely extracts the cluster moniker from a chain identifier.\n * Handles both full chain IDs ('solana:mainnet-beta') and simple monikers ('mainnet-beta').\n * @returns The extracted cluster moniker.\n * @param walletCluster\n * @param cluster\n */\nexport const getCluster = ({ cluster, walletCluster }: { cluster?: string; walletCluster?: string }) => {\n const defaultCluster: SolanaClusterMoniker = 'mainnet';\n if (!cluster) {\n return walletCluster ?? defaultCluster;\n }\n return (cluster.includes(':') ? cluster.split(':')[1] : cluster) as SolanaClusterMoniker;\n};\n\n/**\n * Retrieves the configured RPC URL for a given cluster moniker.\n * @param cluster The target cluster. Defaults to the wallet's active chain.\n * @returns The RPC URL or undefined if not found.\n */\nexport const getRpcUrlForCluster = ({\n cluster,\n walletCluster,\n rpcUrls,\n}: { cluster: SolanaClusterMoniker; walletCluster?: SolanaClusterMoniker } & SolanaRPCUrls) => {\n const targetCluster = walletCluster ?? cluster;\n return rpcUrls[targetCluster] ?? 'https://api.mainnet-beta.solana.com/';\n};\n","import { SolanaClusterMoniker } from 'gill';\n\n/**\n * The default RPC URLs for each Solana cluster.\n * Not all clusters need to be defined; undefined ones will fall back to other logic.\n * @internal\n */\nexport const defaultRpcUrlsByMoniker: Partial<Record<SolanaClusterMoniker, string>> = {\n mainnet: 'https://api.mainnet-beta.solana.com',\n devnet: 'https://api.devnet.solana.com',\n testnet: 'https://api.testnet.solana.com',\n};\n","/**\n * RPC Client Caching Module\n *\n * This module provides a caching mechanism for Solana RPC clients to optimize\n * performance and resource usage by reusing existing client instances.\n *\n * @module RpcClientCache\n */\n\nimport { createSolanaClient, SolanaClient, SolanaClusterMoniker } from 'gill';\n\nimport { defaultRpcUrlsByMoniker } from './defaultRpcUrlsByMoniker';\n\n/**\n * Validates if a string represents a properly formatted URL\n *\n * @param str - String to validate as URL\n * @returns Boolean indicating if the string is a valid URL\n *\n * @example\n * ```typescript\n * isValidUrl('https://api.mainnet-beta.solana.com') // returns true\n * isValidUrl('not-a-url') // returns false\n * ```\n */\nfunction isValidUrl(str: string): boolean {\n try {\n new URL(str);\n return true;\n } catch {\n return false;\n }\n}\n\n/**\n * In-memory cache storage for Solana client instances\n * Maps Solana URLs or monikers to their corresponding client instances\n *\n * @internal\n */\nconst clientsCache = new Map<string, SolanaClient>();\n\n/**\n * Creates or retrieves a cached Solana RPC client instance\n *\n * This function implements a caching mechanism for Solana RPC clients to:\n * - Avoid redundant client instance creation\n * - Optimize memory usage\n * - Maintain consistent client instances throughout the application\n *\n * @param rpcUrlOrMoniker - RPC endpoint URL or cluster moniker (e.g., 'mainnet', 'devnet')\n * @returns Cached or newly created Solana RPC client instance\n * @throws Error if unable to resolve a valid RPC URL\n *\n * @example\n * ```typescript\n * // Using cluster moniker\n * const mainnetClient = createSolanaClientWithCache('mainnet');\n *\n * // Using custom RPC URL\n * const customClient = createSolanaClientWithCache('https://my-rpc.example.com');\n * ```\n */\nexport const createSolanaClientWithCache = ({\n rpcUrlOrMoniker,\n rpcUrls,\n}: {\n rpcUrlOrMoniker: string;\n rpcUrls?: Partial<Record<SolanaClusterMoniker, string>>;\n}): SolanaClient => {\n // Return existing client instance if available in cache\n if (clientsCache.has(rpcUrlOrMoniker)) {\n return clientsCache.get(rpcUrlOrMoniker)!;\n }\n\n // Resolve RPC URL from input: direct URL or cluster moniker\n const rpcUrl = isValidUrl(rpcUrlOrMoniker)\n ? rpcUrlOrMoniker\n : rpcUrls\n ? (rpcUrls[rpcUrlOrMoniker as SolanaClusterMoniker] ??\n defaultRpcUrlsByMoniker[rpcUrlOrMoniker as SolanaClusterMoniker])\n : defaultRpcUrlsByMoniker[rpcUrlOrMoniker as SolanaClusterMoniker];\n\n // Validate resolved RPC URL\n if (!rpcUrl) {\n throw new Error(\n `Unable to resolve RPC URL for input: \"${rpcUrlOrMoniker}\". Ensure it's a valid URL or known moniker.`,\n );\n }\n\n // Create new client instance with resolved URL\n const newClient = createSolanaClient({ urlOrMoniker: rpcUrl });\n\n // Cache and return the new instance\n clientsCache.set(rpcUrlOrMoniker, newClient);\n return newClient;\n};\n","// --- RPC Client Caching ---\n\nimport { createSolanaRpc, Rpc, SolanaClusterMoniker, SolanaRpcApi } from 'gill';\n\nimport { defaultRpcUrlsByMoniker } from './defaultRpcUrlsByMoniker';\n\n/**\n * Validates whether a string is a properly formatted URL.\n * @param str - The string to validate.\n * @returns True if the string is a valid URL, otherwise false.\n */\nfunction isValidUrl(str: string): boolean {\n try {\n new URL(str);\n return true;\n } catch {\n return false;\n }\n}\n\n/**\n * An in-memory cache for RPC clients to avoid redundant instance creation.\n * @internal\n */\nconst rpcCache = new Map<string, Rpc<SolanaRpcApi>>();\n\n/**\n * Retrieves a cached RPC client for a given URL or cluster moniker.\n * If no cached client exists, it creates a new instance.\n *\n * @param rpcUrlOrMoniker - Either a full RPC URL or a cluster moniker like 'mainnet'.\n * @returns The RPC client instance.\n * @internal\n */\nexport const createSolanaRPC = ({\n rpcUrlOrMoniker,\n rpcUrls,\n}: {\n rpcUrlOrMoniker: string;\n rpcUrls?: Partial<Record<SolanaClusterMoniker, string>>;\n}): Rpc<SolanaRpcApi> => {\n // Check the cache first for an existing RPC instance.\n if (rpcCache.has(rpcUrlOrMoniker)) {\n return rpcCache.get(rpcUrlOrMoniker)!;\n }\n // Determine the RPC URL: validate if it's a full URL or fall back to default list.\n const rpcUrl = isValidUrl(rpcUrlOrMoniker)\n ? rpcUrlOrMoniker\n : rpcUrls\n ? (rpcUrls[rpcUrlOrMoniker as SolanaClusterMoniker] ??\n defaultRpcUrlsByMoniker[rpcUrlOrMoniker as SolanaClusterMoniker])\n : defaultRpcUrlsByMoniker[rpcUrlOrMoniker as SolanaClusterMoniker];\n\n // If no valid RPC URL could be resolved, default to the mainnet URL.\n if (!rpcUrl) {\n throw new Error(\n `Unable to resolve RPC URL for input: \"${rpcUrlOrMoniker}\". Ensure it's a valid URL or known moniker.`,\n );\n }\n\n // Create a new RPC client instance.\n const newRpc = createSolanaRpc(rpcUrl);\n\n // Cache the new instance and return it.\n rpcCache.set(rpcUrlOrMoniker, newRpc);\n return newRpc;\n};\n","import { filterUniqueByKey } from '@tuwaio/orbit-core';\nimport { getWallets } from '@wallet-standard/app';\nimport { getOrCreateUiWalletForStandardWallet_DO_NOT_USE_OR_YOU_WILL_BE_FIRED as getOrCreateUiWalletForStandardWallet } from '@wallet-standard/ui-registry';\n\nexport function getAvailableSolanaConnectors() {\n return filterUniqueByKey(getWallets().get().map(getOrCreateUiWalletForStandardWallet), 'name').filter((wallet) => {\n try {\n // Check if wallet has chains property\n if (!wallet || !Array.isArray(wallet.chains)) {\n return false;\n }\n\n // Check if wallet has features property (features should be an array)\n if (!wallet.features || !Array.isArray(wallet.features)) {\n return false;\n }\n\n // Define required features for Solana wallet functionality\n const requiredFeatures = [\n 'standard:connect',\n 'standard:disconnect',\n 'standard:events',\n 'solana:signAndSendTransaction',\n 'solana:signTransaction',\n 'solana:signMessage',\n ] as const;\n\n // Check if wallet supports all required features\n const hasAllFeatures = requiredFeatures.every((requiredFeature) => {\n return wallet.features.includes(requiredFeature);\n });\n\n if (!hasAllFeatures) {\n return false;\n }\n\n // Check if all chains are Solana chains\n return wallet.chains.every((chain) => {\n try {\n if (typeof chain !== 'string') {\n return false;\n }\n const chainParts = chain.split(':');\n return chainParts.length >= 1 && chainParts[0] === 'solana';\n } catch (error) {\n console.warn('Error parsing chain:', chain, error);\n return false;\n }\n });\n } catch (error) {\n console.warn('Error filtering wallet:', error);\n return false;\n }\n });\n}\n","import { lastConnectedConnectorHelpers } from '@tuwaio/orbit-core';\n\nimport { getAvailableSolanaConnectors } from './getAvailableSolanaConnectors';\n\nexport function getConnectedSolanaConnector() {\n const lastConnectedConnector = lastConnectedConnectorHelpers.getLastConnectedConnector();\n const connectors = getAvailableSolanaConnectors();\n const connectedConnector = connectors.find((w) =>\n w.accounts.find((a) => a.address.toLowerCase() === lastConnectedConnector?.address?.toLowerCase()),\n );\n if (!connectedConnector) {\n throw new Error('Connector not provided. Cannot perform chain check.');\n }\n return connectedConnector;\n}\n","/**\n * Cache for Solana avatar lookup results.\n * Key: normalized address/domain (lowercase string), Value: Avatar URL (string).\n */\nconst solanaAvatarCache = new Map<string, string>();\n\n/**\n * SNS API endpoint for resolving domain images\n */\nconst SNS_API_BASE_URL = 'https://image-api.bonfida.com';\n\n/**\n * Interface for SNS Image API response\n */\ninterface SNSImageApiResponse {\n result: { domain: string; image: string }[];\n}\n\n/**\n * Validates if the provided string is a valid Solana address\n *\n * @param address The string to validate\n * @returns boolean indicating if the address is valid\n */\nconst isValidSolanaAddress = (address: string): boolean => {\n return /^[1-9A-HJ-NP-Za-km-z]{32,44}$/.test(address);\n};\n\n/**\n * Validates if the provided string is a valid SNS domain\n *\n * @param domain The string to validate\n * @returns boolean indicating if the domain is valid\n */\nconst isValidSNSDomain = (domain: string): boolean => {\n return /^[a-z0-9-]+\\.sol$/.test(domain.toLowerCase());\n};\n\n/**\n * Fetches the avatar image URL for a given SNS domain using the SNS API\n *\n * @param domain The SNS domain to get avatar for (e.g., \"example.sol\")\n * @returns Promise that resolves to the avatar URL or null if not found\n */\nconst getSNSAvatar = async (domain: string): Promise<string | null> => {\n try {\n const response = await fetch(`${SNS_API_BASE_URL}/image?domain=${encodeURIComponent(domain)}`);\n\n if (!response.ok) {\n return null;\n }\n\n const data: SNSImageApiResponse = await response.json();\n\n if (data.result && Array.isArray(data.result) && data.result.length > 0) {\n const imageData = data.result.find((item) => item.domain === domain);\n return imageData?.image ?? data.result[0]?.image ?? null;\n }\n\n return null;\n } catch (error) {\n console.warn('Failed to fetch SNS avatar:', error);\n return null;\n }\n};\n\n/**\n * Generates a default avatar URL based on address/domain\n * Using DiceBear API for consistent avatars\n *\n * @param identifier The address or domain to generate avatar for\n * @returns Default avatar URL\n */\nconst getDefaultAvatar = (identifier: string): string => {\n const seed = encodeURIComponent(identifier);\n return `https://api.dicebear.com/7.x/identicon/svg?seed=${seed}`;\n};\n\n/**\n * Searches and returns the avatar URL for a given Solana address or SNS domain.\n * Priority order:\n * 1. Check cache\n * 2. If it's a valid SNS domain (.sol), try to get SNS avatar\n * 3. Generate default avatar based on identifier\n *\n * @param addressOrDomain The Solana address or SNS domain to look up avatar for\n * @returns A promise that resolves to the avatar URL\n */\nexport const getSolanaAddressAvatar = async (addressOrDomain: string): Promise<string> => {\n if (!addressOrDomain) {\n return getDefaultAvatar('default');\n }\n\n const trimmedInput = addressOrDomain.trim();\n\n if (!trimmedInput) {\n return getDefaultAvatar('default');\n }\n\n // Normalize the input to use as a cache key\n const normalizedInput = trimmedInput.toLowerCase();\n\n // Check the cache: if the result exists, return it immediately\n const cachedAvatar = solanaAvatarCache.get(normalizedInput);\n if (cachedAvatar !== undefined) {\n return cachedAvatar;\n }\n\n let resultAvatar: string;\n\n try {\n if (isValidSNSDomain(trimmedInput)) {\n const snsAvatar = await getSNSAvatar(trimmedInput);\n if (snsAvatar) {\n resultAvatar = snsAvatar;\n } else {\n resultAvatar = getDefaultAvatar(trimmedInput);\n }\n } else if (isValidSolanaAddress(trimmedInput)) {\n resultAvatar = getDefaultAvatar(trimmedInput);\n } else {\n resultAvatar = getDefaultAvatar(trimmedInput);\n }\n } catch (error) {\n console.warn('Error resolving avatar:', error);\n resultAvatar = getDefaultAvatar(trimmedInput);\n }\n\n // Store the result in the cache\n solanaAvatarCache.set(normalizedInput, resultAvatar);\n\n return resultAvatar;\n};\n\n/**\n * Clears the Solana avatar cache\n */\nexport const clearSolanaAvatarCache = (): void => {\n solanaAvatarCache.clear();\n};\n\n/**\n * Gets the current avatar cache size\n */\nexport const getSolanaAvatarCacheSize = (): number => {\n return solanaAvatarCache.size;\n};\n\n/**\n * Preloads avatar for a given address/domain\n *\n * @param addressOrDomain The address or domain to preload avatar for\n */\nexport const preloadSolanaAvatar = async (addressOrDomain: string): Promise<void> => {\n try {\n await getSolanaAddressAvatar(addressOrDomain);\n } catch (error) {\n console.warn('Failed to preload avatar:', error);\n }\n};\n","/**\n * Cache for Solana address lookup results.\n * Key: normalized address (lowercase string), Value: Account name/label (string).\n */\nconst solanaNameCache = new Map<string, string>();\n\n/**\n * SNS API endpoint for resolving Solana addresses to domain names\n */\nconst SNS_API_BASE_URL = 'https://sns-api.bonfida.com';\n\n/**\n * Interface for SNS API response\n */\ninterface SNSApiResponse {\n result: Record<string, string> | null;\n}\n\n/**\n * Fetches the SNS domain name for a given Solana address using the SNS API\n *\n * @param address The Solana address to resolve\n * @returns Promise that resolves to the SNS domain name or null if not found\n */\nconst getSNSName = async (address: string): Promise<string | null> => {\n try {\n const response = await fetch(`${SNS_API_BASE_URL}/v2/user/fav-domains/${address}`);\n\n if (!response.ok) {\n return null;\n }\n\n const data: SNSApiResponse = await response.json();\n\n if (data.result && typeof data.result === 'object' && address in data.result) {\n return data.result[address];\n }\n\n return null;\n } catch (error) {\n console.warn('Failed to fetch SNS name:', error);\n return null;\n }\n};\n\n/**\n * Validates if the provided string is a valid Solana address\n *\n * @param address The string to validate\n * @returns boolean indicating if the address is valid\n */\nconst isValidSolanaAddress = (address: string): boolean => {\n return /^[1-9A-HJ-NP-Za-km-z]{32,44}$/.test(address);\n};\n\n/**\n * Searches and returns the account name (label) for a given Solana address.\n * Priority order:\n * 1. Check cache\n * 2. Try to resolve SNS domain name\n * 3. Fall back to original address\n *\n * @param address The Solana account address to look up.\n * @returns A promise that resolves to the account's name/label, or the original address string if no name is found.\n */\nexport const getSolanaAddressName = async (address: string): Promise<string> => {\n if (!address) {\n return address || '';\n }\n\n if (!isValidSolanaAddress(address.trim())) {\n return address;\n }\n\n // Normalize the address to use as a cache key, ensuring case-insensitivity.\n const normalizedAddress = address.toLowerCase().trim();\n\n // Check the cache: if the result exists, return it immediately.\n const cachedName = solanaNameCache.get(normalizedAddress);\n if (cachedName !== undefined) {\n return cachedName;\n }\n\n let resultName = address; // Default fallback\n\n try {\n const snsName = await getSNSName(address);\n if (snsName) {\n resultName = snsName;\n }\n } catch (error) {\n console.warn('Error resolving address name:', error);\n // resultName остается как оригинальный адрес\n }\n\n // Store the result in the cache\n solanaNameCache.set(normalizedAddress, resultName);\n\n return resultName;\n};\n\n/**\n * Clears the Solana name cache\n */\nexport const clearSolanaNameCache = (): void => {\n solanaNameCache.clear();\n};\n\n/**\n * Gets the current cache size\n */\nexport const getSolanaNameCacheSize = (): number => {\n return solanaNameCache.size;\n};\n","/**\n * @file This file contains a utility function for generating Solana transaction explorer links.\n */\n\nimport { getExplorerLink } from 'gill';\n\nimport { getCluster } from './clusterHelpers';\n\n/**\n * Generates a full URL to a transaction on a Solana explorer like Solscan.\n *\n * @param {string} url - The url after baseUrl.\n * @param chainId\n * @returns {string} The full URL to the transaction on the explorer.\n */\nexport const getSolanaExplorerLink = (url?: string, chainId?: string | number | undefined): string => {\n const cluster = getCluster({ cluster: String(chainId) }) ?? 'mainnet';\n // Ensure there are no trailing slashes on the base URL for clean URL construction.\n const baseUrl = getExplorerLink();\n const sanitizedBaseUrl = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;\n // Build the cluster query parameter if provided.\n const clusterParam = cluster ? `?cluster=${cluster}` : '';\n\n return `${sanitizedBaseUrl}${url ? url : '/'}${clusterParam}`;\n};\n"]}
|
package/dist/index.mjs.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/utils/clusterHelpers.ts","../src/utils/defaultRpcUrlsByMoniker.ts","../src/utils/createSolanaClientWithCache.ts","../src/utils/createSolanaRPC.ts","../src/utils/getAvailableSolanaConnectors.ts","../src/utils/getConnectedSolanaConnector.ts","../src/utils/getSolanaAddressAvatar.ts","../src/utils/getSolanaAddressName.ts","../src/utils/getSolanaExplorerLink.ts"],"names":["getCluster","cluster","walletCluster","defaultCluster","getRpcUrlForCluster","rpcUrls","defaultRpcUrlsByMoniker","isValidUrl","str","clientsCache","createSolanaClientWithCache","rpcUrlOrMoniker","rpcUrl","newClient","createSolanaClient","rpcCache","createSolanaRPC","newRpc","createSolanaRpc","getAvailableSolanaConnectors","filterUniqueByKey","getWallets","getOrCreateUiWalletForStandardWallet","wallet","requiredFeature","chain","chainParts","error","getConnectedSolanaConnector","lastConnectedConnector","lastConnectedConnectorHelpers","connectedConnector","w","solanaAvatarCache","SNS_API_BASE_URL","isValidSolanaAddress","address","isValidSNSDomain","domain","getSNSAvatar","response","data","item","getDefaultAvatar","identifier","getSolanaAddressAvatar","addressOrDomain","trimmedInput","normalizedInput","cachedAvatar","resultAvatar","snsAvatar","clearSolanaAvatarCache","getSolanaAvatarCacheSize","preloadSolanaAvatar","solanaNameCache","getSNSName","getSolanaAddressName","normalizedAddress","cachedName","resultName","snsName","clearSolanaNameCache","getSolanaNameCacheSize","getSolanaExplorerLink","url","chainId","baseUrl","getExplorerLink","sanitizedBaseUrl","clusterParam"],"mappings":"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","file":"index.mjs","sourcesContent":["import type { SolanaClusterMoniker } from 'gill';\n\nimport { SolanaRPCUrls } from '../types';\n\n/**\n * Safely extracts the cluster moniker from a chain identifier.\n * Handles both full chain IDs ('solana:mainnet-beta') and simple monikers ('mainnet-beta').\n * @returns The extracted cluster moniker.\n * @param walletCluster\n * @param cluster\n */\nexport const getCluster = ({ cluster, walletCluster }: { cluster?: string; walletCluster?: string }) => {\n const defaultCluster: SolanaClusterMoniker = 'mainnet';\n if (!cluster) {\n return walletCluster ?? defaultCluster;\n }\n return (cluster.includes(':') ? cluster.split(':')[1] : cluster) as SolanaClusterMoniker;\n};\n\n/**\n * Retrieves the configured RPC URL for a given cluster moniker.\n * @param cluster The target cluster. Defaults to the wallet's active chain.\n * @returns The RPC URL or undefined if not found.\n */\nexport const getRpcUrlForCluster = ({\n cluster,\n walletCluster,\n rpcUrls,\n}: { cluster: SolanaClusterMoniker; walletCluster?: SolanaClusterMoniker } & SolanaRPCUrls) => {\n const targetCluster = walletCluster ?? cluster;\n return rpcUrls[targetCluster] ?? 'https://api.mainnet-beta.solana.com/';\n};\n","import { SolanaClusterMoniker } from 'gill';\n\n/**\n * The default RPC URLs for each Solana cluster.\n * Not all clusters need to be defined; undefined ones will fall back to other logic.\n * @internal\n */\nexport const defaultRpcUrlsByMoniker: Partial<Record<SolanaClusterMoniker, string>> = {\n mainnet: 'https://api.mainnet-beta.solana.com',\n devnet: 'https://api.devnet.solana.com',\n testnet: 'https://api.testnet.solana.com',\n};\n","/**\n * RPC Client Caching Module\n *\n * This module provides a caching mechanism for Solana RPC clients to optimize\n * performance and resource usage by reusing existing client instances.\n *\n * @module RpcClientCache\n */\n\nimport { createSolanaClient, SolanaClient, SolanaClusterMoniker } from 'gill';\n\nimport { defaultRpcUrlsByMoniker } from './defaultRpcUrlsByMoniker';\n\n/**\n * Validates if a string represents a properly formatted URL\n *\n * @param str - String to validate as URL\n * @returns Boolean indicating if the string is a valid URL\n *\n * @example\n * ```typescript\n * isValidUrl('https://api.mainnet-beta.solana.com') // returns true\n * isValidUrl('not-a-url') // returns false\n * ```\n */\nfunction isValidUrl(str: string): boolean {\n try {\n new URL(str);\n return true;\n } catch {\n return false;\n }\n}\n\n/**\n * In-memory cache storage for Solana client instances\n * Maps Solana URLs or monikers to their corresponding client instances\n *\n * @internal\n */\nconst clientsCache = new Map<string, SolanaClient>();\n\n/**\n * Creates or retrieves a cached Solana RPC client instance\n *\n * This function implements a caching mechanism for Solana RPC clients to:\n * - Avoid redundant client instance creation\n * - Optimize memory usage\n * - Maintain consistent client instances throughout the application\n *\n * @param rpcUrlOrMoniker - RPC endpoint URL or cluster moniker (e.g., 'mainnet', 'devnet')\n * @returns Cached or newly created Solana RPC client instance\n * @throws Error if unable to resolve a valid RPC URL\n *\n * @example\n * ```typescript\n * // Using cluster moniker\n * const mainnetClient = createSolanaClientWithCache('mainnet');\n *\n * // Using custom RPC URL\n * const customClient = createSolanaClientWithCache('https://my-rpc.example.com');\n * ```\n */\nexport const createSolanaClientWithCache = ({\n rpcUrlOrMoniker,\n rpcUrls,\n}: {\n rpcUrlOrMoniker: string;\n rpcUrls?: Partial<Record<SolanaClusterMoniker, string>>;\n}): SolanaClient => {\n // Return existing client instance if available in cache\n if (clientsCache.has(rpcUrlOrMoniker)) {\n return clientsCache.get(rpcUrlOrMoniker)!;\n }\n\n // Resolve RPC URL from input: direct URL or cluster moniker\n const rpcUrl = isValidUrl(rpcUrlOrMoniker)\n ? rpcUrlOrMoniker\n : rpcUrls\n ? (rpcUrls[rpcUrlOrMoniker as SolanaClusterMoniker] ??\n defaultRpcUrlsByMoniker[rpcUrlOrMoniker as SolanaClusterMoniker])\n : defaultRpcUrlsByMoniker[rpcUrlOrMoniker as SolanaClusterMoniker];\n\n // Validate resolved RPC URL\n if (!rpcUrl) {\n throw new Error(\n `Unable to resolve RPC URL for input: \"${rpcUrlOrMoniker}\". Ensure it's a valid URL or known moniker.`,\n );\n }\n\n // Create new client instance with resolved URL\n const newClient = createSolanaClient({ urlOrMoniker: rpcUrl });\n\n // Cache and return the new instance\n clientsCache.set(rpcUrlOrMoniker, newClient);\n return newClient;\n};\n","// --- RPC Client Caching ---\n\nimport { createSolanaRpc, Rpc, SolanaClusterMoniker, SolanaRpcApi } from 'gill';\n\nimport { defaultRpcUrlsByMoniker } from './defaultRpcUrlsByMoniker';\n\n/**\n * Validates whether a string is a properly formatted URL.\n * @param str - The string to validate.\n * @returns True if the string is a valid URL, otherwise false.\n */\nfunction isValidUrl(str: string): boolean {\n try {\n new URL(str);\n return true;\n } catch {\n return false;\n }\n}\n\n/**\n * An in-memory cache for RPC clients to avoid redundant instance creation.\n * @internal\n */\nconst rpcCache = new Map<string, Rpc<SolanaRpcApi>>();\n\n/**\n * Retrieves a cached RPC client for a given URL or cluster moniker.\n * If no cached client exists, it creates a new instance.\n *\n * @param rpcUrlOrMoniker - Either a full RPC URL or a cluster moniker like 'mainnet'.\n * @returns The RPC client instance.\n * @internal\n */\nexport const createSolanaRPC = ({\n rpcUrlOrMoniker,\n rpcUrls,\n}: {\n rpcUrlOrMoniker: string;\n rpcUrls?: Partial<Record<SolanaClusterMoniker, string>>;\n}): Rpc<SolanaRpcApi> => {\n // Check the cache first for an existing RPC instance.\n if (rpcCache.has(rpcUrlOrMoniker)) {\n return rpcCache.get(rpcUrlOrMoniker)!;\n }\n // Determine the RPC URL: validate if it's a full URL or fall back to default list.\n const rpcUrl = isValidUrl(rpcUrlOrMoniker)\n ? rpcUrlOrMoniker\n : rpcUrls\n ? (rpcUrls[rpcUrlOrMoniker as SolanaClusterMoniker] ??\n defaultRpcUrlsByMoniker[rpcUrlOrMoniker as SolanaClusterMoniker])\n : defaultRpcUrlsByMoniker[rpcUrlOrMoniker as SolanaClusterMoniker];\n\n // If no valid RPC URL could be resolved, default to the mainnet URL.\n if (!rpcUrl) {\n throw new Error(\n `Unable to resolve RPC URL for input: \"${rpcUrlOrMoniker}\". Ensure it's a valid URL or known moniker.`,\n );\n }\n\n // Create a new RPC client instance.\n const newRpc = createSolanaRpc(rpcUrl);\n\n // Cache the new instance and return it.\n rpcCache.set(rpcUrlOrMoniker, newRpc);\n return newRpc;\n};\n","import { filterUniqueByKey } from '@tuwaio/orbit-core';\nimport { getWallets } from '@wallet-standard/app';\nimport { getOrCreateUiWalletForStandardWallet_DO_NOT_USE_OR_YOU_WILL_BE_FIRED as getOrCreateUiWalletForStandardWallet } from '@wallet-standard/ui-registry';\n\nexport function getAvailableSolanaConnectors() {\n return filterUniqueByKey(getWallets().get().map(getOrCreateUiWalletForStandardWallet), 'name').filter((wallet) => {\n try {\n // Check if wallet has chains property\n if (!wallet || !Array.isArray(wallet.chains)) {\n return false;\n }\n\n // Check if wallet has features property (features should be an array)\n if (!wallet.features || !Array.isArray(wallet.features)) {\n return false;\n }\n\n // Define required features for Solana wallet functionality\n const requiredFeatures = [\n 'standard:connect',\n 'standard:disconnect',\n 'standard:events',\n 'solana:signAndSendTransaction',\n 'solana:signTransaction',\n 'solana:signMessage',\n ] as const;\n\n // Check if wallet supports all required features\n const hasAllFeatures = requiredFeatures.every((requiredFeature) => {\n return wallet.features.includes(requiredFeature);\n });\n\n if (!hasAllFeatures) {\n return false;\n }\n\n // Check if all chains are Solana chains\n return wallet.chains.every((chain) => {\n try {\n if (typeof chain !== 'string') {\n return false;\n }\n const chainParts = chain.split(':');\n return chainParts.length >= 1 && chainParts[0] === 'solana';\n } catch (error) {\n console.warn('Error parsing chain:', chain, error);\n return false;\n }\n });\n } catch (error) {\n console.warn('Error filtering wallet:', error);\n return false;\n }\n });\n}\n","import { lastConnectedConnectorHelpers } from '@tuwaio/orbit-core';\n\nimport { getAvailableSolanaConnectors } from './getAvailableSolanaConnectors';\n\nexport function getConnectedSolanaConnector() {\n const lastConnectedConnector = lastConnectedConnectorHelpers.getLastConnectedConnector();\n const connectors = getAvailableSolanaConnectors();\n const connectedConnector = connectors.find((w) =>\n w.accounts.find((a) => a.address.toLowerCase() === lastConnectedConnector?.address?.toLowerCase()),\n );\n if (!connectedConnector) {\n throw new Error('Connector not provided. Cannot perform chain check.');\n }\n return connectedConnector;\n}\n","/**\n * Cache for Solana avatar lookup results.\n * Key: normalized address/domain (lowercase string), Value: Avatar URL (string).\n */\nconst solanaAvatarCache = new Map<string, string>();\n\n/**\n * SNS API endpoint for resolving domain images\n */\nconst SNS_API_BASE_URL = 'https://image-api.bonfida.com';\n\n/**\n * Interface for SNS Image API response\n */\ninterface SNSImageApiResponse {\n result: { domain: string; image: string }[];\n}\n\n/**\n * Validates if the provided string is a valid Solana address\n *\n * @param address The string to validate\n * @returns boolean indicating if the address is valid\n */\nconst isValidSolanaAddress = (address: string): boolean => {\n return /^[1-9A-HJ-NP-Za-km-z]{32,44}$/.test(address);\n};\n\n/**\n * Validates if the provided string is a valid SNS domain\n *\n * @param domain The string to validate\n * @returns boolean indicating if the domain is valid\n */\nconst isValidSNSDomain = (domain: string): boolean => {\n return /^[a-z0-9-]+\\.sol$/.test(domain.toLowerCase());\n};\n\n/**\n * Fetches the avatar image URL for a given SNS domain using the SNS API\n *\n * @param domain The SNS domain to get avatar for (e.g., \"example.sol\")\n * @returns Promise that resolves to the avatar URL or null if not found\n */\nconst getSNSAvatar = async (domain: string): Promise<string | null> => {\n try {\n const response = await fetch(`${SNS_API_BASE_URL}/image?domain=${encodeURIComponent(domain)}`);\n\n if (!response.ok) {\n return null;\n }\n\n const data: SNSImageApiResponse = await response.json();\n\n if (data.result && Array.isArray(data.result) && data.result.length > 0) {\n const imageData = data.result.find((item) => item.domain === domain);\n return imageData?.image ?? data.result[0]?.image ?? null;\n }\n\n return null;\n } catch (error) {\n console.warn('Failed to fetch SNS avatar:', error);\n return null;\n }\n};\n\n/**\n * Generates a default avatar URL based on address/domain\n * Using DiceBear API for consistent avatars\n *\n * @param identifier The address or domain to generate avatar for\n * @returns Default avatar URL\n */\nconst getDefaultAvatar = (identifier: string): string => {\n const seed = encodeURIComponent(identifier);\n return `https://api.dicebear.com/7.x/identicon/svg?seed=${seed}`;\n};\n\n/**\n * Searches and returns the avatar URL for a given Solana address or SNS domain.\n * Priority order:\n * 1. Check cache\n * 2. If it's a valid SNS domain (.sol), try to get SNS avatar\n * 3. Generate default avatar based on identifier\n *\n * @param addressOrDomain The Solana address or SNS domain to look up avatar for\n * @returns A promise that resolves to the avatar URL\n */\nexport const getSolanaAddressAvatar = async (addressOrDomain: string): Promise<string> => {\n if (!addressOrDomain) {\n return getDefaultAvatar('default');\n }\n\n const trimmedInput = addressOrDomain.trim();\n\n if (!trimmedInput) {\n return getDefaultAvatar('default');\n }\n\n // Normalize the input to use as a cache key\n const normalizedInput = trimmedInput.toLowerCase();\n\n // Check the cache: if the result exists, return it immediately\n const cachedAvatar = solanaAvatarCache.get(normalizedInput);\n if (cachedAvatar !== undefined) {\n return cachedAvatar;\n }\n\n let resultAvatar: string;\n\n try {\n if (isValidSNSDomain(trimmedInput)) {\n const snsAvatar = await getSNSAvatar(trimmedInput);\n if (snsAvatar) {\n resultAvatar = snsAvatar;\n } else {\n resultAvatar = getDefaultAvatar(trimmedInput);\n }\n } else if (isValidSolanaAddress(trimmedInput)) {\n resultAvatar = getDefaultAvatar(trimmedInput);\n } else {\n resultAvatar = getDefaultAvatar(trimmedInput);\n }\n } catch (error) {\n console.warn('Error resolving avatar:', error);\n resultAvatar = getDefaultAvatar(trimmedInput);\n }\n\n // Store the result in the cache\n solanaAvatarCache.set(normalizedInput, resultAvatar);\n\n return resultAvatar;\n};\n\n/**\n * Clears the Solana avatar cache\n */\nexport const clearSolanaAvatarCache = (): void => {\n solanaAvatarCache.clear();\n};\n\n/**\n * Gets the current avatar cache size\n */\nexport const getSolanaAvatarCacheSize = (): number => {\n return solanaAvatarCache.size;\n};\n\n/**\n * Preloads avatar for a given address/domain\n *\n * @param addressOrDomain The address or domain to preload avatar for\n */\nexport const preloadSolanaAvatar = async (addressOrDomain: string): Promise<void> => {\n try {\n await getSolanaAddressAvatar(addressOrDomain);\n } catch (error) {\n console.warn('Failed to preload avatar:', error);\n }\n};\n","/**\n * Cache for Solana address lookup results.\n * Key: normalized address (lowercase string), Value: Account name/label (string).\n */\nconst solanaNameCache = new Map<string, string>();\n\n/**\n * SNS API endpoint for resolving Solana addresses to domain names\n */\nconst SNS_API_BASE_URL = 'https://sns-api.bonfida.com';\n\n/**\n * Interface for SNS API response\n */\ninterface SNSApiResponse {\n result: Record<string, string> | null;\n}\n\n/**\n * Fetches the SNS domain name for a given Solana address using the SNS API\n *\n * @param address The Solana address to resolve\n * @returns Promise that resolves to the SNS domain name or null if not found\n */\nconst getSNSName = async (address: string): Promise<string | null> => {\n try {\n const response = await fetch(`${SNS_API_BASE_URL}/v2/user/fav-domains/${address}`);\n\n if (!response.ok) {\n return null;\n }\n\n const data: SNSApiResponse = await response.json();\n\n if (data.result && typeof data.result === 'object' && address in data.result) {\n return data.result[address];\n }\n\n return null;\n } catch (error) {\n console.warn('Failed to fetch SNS name:', error);\n return null;\n }\n};\n\n/**\n * Validates if the provided string is a valid Solana address\n *\n * @param address The string to validate\n * @returns boolean indicating if the address is valid\n */\nconst isValidSolanaAddress = (address: string): boolean => {\n return /^[1-9A-HJ-NP-Za-km-z]{32,44}$/.test(address);\n};\n\n/**\n * Searches and returns the account name (label) for a given Solana address.\n * Priority order:\n * 1. Check cache\n * 2. Try to resolve SNS domain name\n * 3. Fall back to original address\n *\n * @param address The Solana account address to look up.\n * @returns A promise that resolves to the account's name/label, or the original address string if no name is found.\n */\nexport const getSolanaAddressName = async (address: string): Promise<string> => {\n if (!address) {\n return address || '';\n }\n\n if (!isValidSolanaAddress(address.trim())) {\n return address;\n }\n\n // Normalize the address to use as a cache key, ensuring case-insensitivity.\n const normalizedAddress = address.toLowerCase().trim();\n\n // Check the cache: if the result exists, return it immediately.\n const cachedName = solanaNameCache.get(normalizedAddress);\n if (cachedName !== undefined) {\n return cachedName;\n }\n\n let resultName = address; // Default fallback\n\n try {\n const snsName = await getSNSName(address);\n if (snsName) {\n resultName = snsName;\n }\n } catch (error) {\n console.warn('Error resolving address name:', error);\n // resultName остается как оригинальный адрес\n }\n\n // Store the result in the cache\n solanaNameCache.set(normalizedAddress, resultName);\n\n return resultName;\n};\n\n/**\n * Clears the Solana name cache\n */\nexport const clearSolanaNameCache = (): void => {\n solanaNameCache.clear();\n};\n\n/**\n * Gets the current cache size\n */\nexport const getSolanaNameCacheSize = (): number => {\n return solanaNameCache.size;\n};\n","/**\n * @file This file contains a utility function for generating Solana transaction explorer links.\n */\n\nimport { getExplorerLink } from 'gill';\n\nimport { getCluster } from './clusterHelpers';\n\n/**\n * Generates a full URL to a transaction on a Solana explorer like Solscan.\n *\n * @param {string} url - The url after baseUrl.\n * @param chainId\n * @returns {string} The full URL to the transaction on the explorer.\n */\nexport const getSolanaExplorerLink = (url?: string, chainId?: string | number | undefined): string => {\n const cluster = getCluster({ cluster: String(chainId) }) ?? 'mainnet';\n // Ensure there are no trailing slashes on the base URL for clean URL construction.\n const baseUrl = getExplorerLink();\n const sanitizedBaseUrl = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;\n // Build the cluster query parameter if provided.\n const clusterParam = cluster ? `?cluster=${cluster}` : '';\n\n return `${sanitizedBaseUrl}${url ? url : '/'}${clusterParam}`;\n};\n"]}
|