@mycelium-sdk/core 0.1.0 → 1.0.0-alpha.0

package/dist/index.js

@@ -461,7 +461,7 @@ var DefaultSmartWallet = class extends SmartWallet {
    * Funds the smart wallet with the specified amount of the specified token via Coinbase CDP on-ramp service
    *
    * @public
-   * @category Ramp
+   * @category Funding
    *
    * @remarks
    * If Coinbase CDP is not initialized, the method will throw an error. For more details, visit @see {@link https://docs.cdp.coinbase.com/api-reference/v2/rest-api/onramp/create-an-onramp-session}
@@ -499,7 +499,7 @@ var DefaultSmartWallet = class extends SmartWallet {
    * Cashout token from smart wallet to fiat currency via Coinbase CDP off-ramp service
    *
    * @public
-   * @category Ramp
+   * @category Funding
    *
    * @remarks
    * If Coinbase CDP is not initialized, the method will throw an error. For more details, visit @see {@link https://docs.cdp.coinbase.com/api-reference/rest-api/onramp-offramp/create-sell-quote}
@@ -575,6 +575,42 @@ var DefaultSmartWallet = class extends SmartWallet {
   }
 };
 
+// src/ramp/FundingNamespace.ts
+var FundingNamespace = class {
+  constructor(coinbaseCDP) {
+    this.coinbaseCDP = null;
+    if (!coinbaseCDP) {
+      throw new Error(
+        "Coinbase CDP is not initialized. Please, provide the configuration in the SDK initialization"
+      );
+    }
+    this.coinbaseCDP = coinbaseCDP;
+  }
+  /**
+   * Return all supported countries and payment methods for on-ramp by Coinbase CDP
+   * @public
+   * @category Funding
+   *
+   * @returns @see {@link RampConfigResponse} with supported countries and payment methods for top-up
+   * @throws If API returned an error
+   */
+  async getTopUpConfig() {
+    return await this.coinbaseCDP.getOnRampConfig();
+  }
+  /**
+   * Return all supported countries and payment methods for off-ramp by Coinbase CDP
+   * @public
+   * @category Funding
+   *
+   *
+   * @returns @see {@link RampConfigResponse} with supported countries and payment methods for cash out
+   * @throws If API returned an error
+   */
+  async getCashOutConfig() {
+    return await this.coinbaseCDP.getOffRampConfig();
+  }
+};
+
 // src/tools/ChainManager.ts
 import { createPublicClient, http } from "viem";
 import {
@@ -882,32 +918,6 @@ var WalletNamespace = class {
   constructor(provider) {
     this.provider = provider;
   }
-  /**
-   * Direct access to the underlying embedded wallet provider
-   *
-   * @public
-   * @category Providers
-   * @remarks
-   * Useful when you need advanced functionality beyond the unified namespace. By default, you should use the unified namespace
-   *
-   * @returns The configured embedded wallet provider instance
-   */
-  get embeddedWalletProvider() {
-    return this.provider.embeddedWalletProvider;
-  }
-  /**
-   * Direct access to the underlying smart wallet provider
-   *
-   * @public
-   * @category Providers
-   * @remarks
-   * Useful when you need advanced functionality beyond the unified namespace. By default, you should use the unified namespace
-   *
-   * @returns The configured smart wallet provider instance
-   */
-  get smartWalletProvider() {
-    return this.provider.smartWalletProvider;
-  }
   /**
    * Creates an embedded wallet
    *
@@ -940,7 +950,7 @@ var WalletNamespace = class {
     return this.provider.createSmartWallet(params);
   }
   /**
-   * Creates a smart wallet with an embedded wallet as signer
+   * A unified a web3 account: creates a smart wallet with an embedded wallet as signer
    *
    * @public
    * @category Creation
@@ -954,11 +964,11 @@ var WalletNamespace = class {
    * @param params.nonce Optional nonce/salt for deterministic address generation (defaults to 0)
    * @returns Promise that resolves to the created {@link SmartWallet}
    */
-  async createWalletWithEmbeddedSigner(params) {
-    return this.provider.createWalletWithEmbeddedSigner(params);
+  async createAccount(params) {
+    return this.provider.createAccount(params);
   }
   /**
-   * Gets a smart wallet using an embedded wallet as the signer
+   * Gets a unified web3 account: a smart wallet using an embedded wallet as the signer
    *
    * @public
    * @category Retrieval
@@ -976,8 +986,8 @@ var WalletNamespace = class {
    * @returns Promise that resolves to the {@link SmartWallet}
    * @throws Error if the embedded wallet cannot be found
    */
-  async getSmartWalletWithEmbeddedSigner(params) {
-    return this.provider.getSmartWalletWithEmbeddedSigner(params);
+  async getAccount(params) {
+    return this.provider.getAccount(params);
   }
   /**
    * Gets an existing embedded wallet by ID
@@ -1133,18 +1143,6 @@ var DefaultSmartWalletProvider = class extends SmartWalletProvider {
       ownerIndex
     );
   }
-  /**
-   * Funds a wallet via a faucet if supported by the selected chain
-   *
-   * @internal
-   * @category Funding
-   * @remarks
-   * Placeholder for testnet faucet integration
-   *
-   * @returns Future transaction hash or provider response
-   */
-  fundViaFaucet() {
-  }
 };
 
 // src/wallet/WalletProvider.ts
@@ -1208,9 +1206,12 @@ var WalletProvider = class {
    * @param params.nonce Optional salt/nonce for deterministic address calculation (defaults to 0)
    * @returns Promise that resolves to the created {@link SmartWallet}
    */
-  async createWalletWithEmbeddedSigner(params) {
+  async createAccount(params) {
     const { owners: ownersParam, embeddedWalletIndex, nonce } = params || {};
     const embeddedWallet = await this.embeddedWalletProvider.createWallet();
+    if (!embeddedWallet.walletId) {
+      throw new Error("Failed to create embedded wallet. No wallet ID returned");
+    }
     const account = await embeddedWallet.account();
     let owners;
     if (ownersParam) {
@@ -1220,14 +1221,18 @@ var WalletProvider = class {
     } else {
       owners = [embeddedWallet.address];
     }
-    return this.smartWalletProvider.createWallet({
+    const smartWallet = await this.smartWalletProvider.createWallet({
       owners,
       signer: account,
       nonce
     });
+    return {
+      embeddedWalletId: embeddedWallet.walletId,
+      smartWallet
+    };
   }
   /**
-   * Gets a smart wallet using an embedded wallet as the signer
+   * Gets a unified web3 account: a smart wallet using an embedded wallet as the signer
    *
    * @internal
    * @remarks
@@ -1244,7 +1249,7 @@ var WalletProvider = class {
    * @returns Promise that resolves to the {@link SmartWallet}
    * @throws Error if the embedded wallet cannot be found
    */
-  async getSmartWalletWithEmbeddedSigner(params) {
+  async getAccount(params) {
     const { walletId, deploymentOwners, walletAddress } = params;
     const embeddedWallet = await this.embeddedWalletProvider.getWallet({
       walletId
@@ -2324,6 +2329,15 @@ var MyceliumSDK = class {
    * @see MyceliumSDKConfig
    */
   constructor(config) {
+    /**
+     * Ramp namespace to manage ramp operations. Methods are available on {@link RampNamespace}
+     * @internal
+     * @remarks
+     * If the Coinbase CDP configuration is not provided, the ramp functionality will be disabled.
+     * Calling the respective method will throw an error
+     * @category Tools
+     */
+    this.fundingNamespace = null;
     /**
      * Coinbase CDP instance to Coinbase related and onchain operations using Coinbase CDP API
      * @remarks
@@ -2332,46 +2346,6 @@ var MyceliumSDK = class {
      * @internal
      */
     this.coinbaseCDP = null;
-    /**
-     * Coinbase CDP configuration methods for ramp operations
-     * @public
-     * @category Tools
-     */
-    this.rampConfig = {
-      /**
-       * Return all supported countries and payment methods for on-ramp by Coinbase CDP
-       * @public
-       * @category Ramp
-       *
-       * @returns @see {@link RampConfigResponse} with supported countries and payment methods for top-up
-       * @throws If API returned an error
-       */
-      getTopUpConfig: async () => {
-        if (!this.coinbaseCDP) {
-          throw new Error(
-            "Coinbase CDP is not initialized. Please, provide the configuration in the SDK initialization"
-          );
-        }
-        return await this.coinbaseCDP.getOnRampConfig();
-      },
-      /**
-       * Return all supported countries and payment methods for off-ramp by Coinbase CDP
-       * @public
-       * @category Ramp
-       *
-       *
-       * @returns @see {@link RampConfigResponse} with supported countries and payment methods for cash out
-       * @throws If API returned an error
-       */
-      getCashOutConfig: async () => {
-        if (!this.coinbaseCDP) {
-          throw new Error(
-            "Coinbase CDP is not initialized. Please, provide the configuration in the SDK initialization"
-          );
-        }
-        return await this.coinbaseCDP.getOffRampConfig();
-      }
-    };
     this._chainManager = new ChainManager(
       config.chain || {
         chainId: base3.id,
@@ -2392,6 +2366,7 @@ var MyceliumSDK = class {
         config.integratorId,
         this.chainManager
       );
+      this.fundingNamespace = new FundingNamespace(this.coinbaseCDP);
     }
     const protocolsRouterConfig = config.protocolsRouterConfig || {
       riskLevel: "low"
@@ -2402,6 +2377,8 @@ var MyceliumSDK = class {
   /**
    * Returns the chain manager instance for multi-chain operations
    * @public
+   * @remarks
+   * More about methods in {@link ChainManager}
    * @category Tools
    *
    * @returns ChainManager instance of the type {@link ChainManager}
@@ -2409,6 +2386,23 @@ var MyceliumSDK = class {
   get chainManager() {
     return this._chainManager;
   }
+  /**
+   * Returns a funding namespace to manage top ups & cash outs configurations
+   * @public
+   * @remarks
+   * More about methods in {@link FundingNamespace}
+   * @category Tools
+   *
+   * @returns Funding namespace of the type {@link FundingNamespace}
+   */
+  get funding() {
+    if (!this.fundingNamespace) {
+      throw new Error(
+        "Ramp namespace is not initialized. Please, provide the configuration in the SDK initialization"
+      );
+    }
+    return this.fundingNamespace;
+  }
   /**
    * Recommends and initializes a protocol based on router settings
    *
@@ -2476,6 +2470,7 @@ var MyceliumSDK = class {
 };
 export {
   DefaultSmartWallet,
+  FundingNamespace,
   MyceliumSDK
 };
 //# sourceMappingURL=index.js.map