@digitalworld/digital-world-sdk 16.0.0 → 16.0.1

package/README.md

@@ -9,7 +9,7 @@
 
 `digital-world-js-sdk` is a JavaScript library for communicating with a
 [Digital World Gateway](https://docs.digitalworld.global/docs/data/apis/horizon)
-and [Stellar RPC](https://docs.digitalworld.global/docs/data/apis/rpc). While
+and [Soroban RPC](https://docs.digitalworld.global/docs/data/apis/rpc). While
 primarily intended for applications built on Node.js or in the browser, it can
 be adapted for use in other environments with some tinkering.
 
@@ -29,7 +29,7 @@ The library provides:
   - [...with React Native](#usage-with-react-native)
   - [...with Expo](#usage-with-expo-managed-workflows)
   - [...with CloudFlare Workers](#usage-with-cloudflare-workers)
-- [CLI](#cli): generate TypeScript bindings for Stellar smart contracts
+- [CLI](#cli): generate TypeScript bindings for Digital World smart contracts
 - [Developing](#developing): contribute to the project!
 - [License](#license)
 
@@ -163,7 +163,7 @@ local branch, run `pnpm docs:llms`; the generated files are written under
 You can also refer to:
 
 - the [documentation](https://docs.digitalworld.global/docs/data/horizon) for the
-  Gateway REST API (if using the `Horizon` module) and
+  Gateway REST API (if using the `Gateway` module) and
 - the [documentation](https://docs.digitalworld.global/docs/data/rpc) for Soroban
   RPC's API (if using the `rpc` module)
 
@@ -224,7 +224,7 @@ are:
 ## CLI
 
 The SDK includes a command-line tool for generating TypeScript bindings from
-Stellar smart contracts. These bindings provide fully-typed client code with IDE
+Digital World smart contracts. These bindings provide fully-typed client code with IDE
 autocompletion and compile-time type checking.
 
 ### Running the CLI
@@ -313,7 +313,7 @@ npx @digitalworld/digital-world-sdk generate \
 | `--wasm <path>`          | Path to a local WASM file                                                                       |
 | `--wasm-hash <hash>`     | Hex-encoded hash of WASM blob on the network                                                    |
 | `--contract-id <id>`     | Contract ID of a deployed contract                                                              |
-| `--rpc-url <url>`        | Stellar RPC server URL (has defaults for testnet/localnet, required for mainnet)                |
+| `--rpc-url <url>`        | Soroban RPC server URL (has defaults for testnet/localnet, required for mainnet)                |
 | `--network <network>`    | Network to use: `testnet`, `mainnet`, or `localnet` (required for network sources)              |
 | `--output-dir <dir>`     | Output directory for generated bindings (required)                                              |
 | `--contract-name <name>` | Name for the generated package (derived from filename if not provided)                          |

package/dist/digital-world-sdk-axios.js

@@ -38913,7 +38913,7 @@
       ...opts.auth !== void 0 && { auth: opts.auth }
     });
   }
-  function createStellarAssetContract(opts) {
+  function createDigitalWorldAssetContract(opts) {
     let asset = opts.asset;
     if (typeof asset === "string") {
       const parts = asset.split(":");
@@ -39291,7 +39291,7 @@
     static restoreFootprint = restoreFootprint;
     // These are not `xdr.Operation`s directly, but proxies for common
     // versions of `Operation.invokeHostFunction`
-    static createStellarAssetContract = createStellarAssetContract;
+    static createDigitalWorldAssetContract = createDigitalWorldAssetContract;
     static invokeContractFunction = invokeContractFunction;
     static createCustomContract = createCustomContract;
     static uploadContractWasm = uploadContractWasm;
@@ -40362,7 +40362,7 @@
       }
     }
     /**
-     * Returns Stellar contract ID as a strkey, ex.
+     * Returns Digital World contract ID as a strkey, ex.
      * `CA3D5KRYM6CB7OWQ6TWYRR3Z4T7GNZLKERYNZGGA5SOAOPIFY6YQGAXE`.
      */
     contractId() {
@@ -40385,7 +40385,7 @@
      * @see Operation.invokeHostFunction
      * @see Operation.invokeContractFunction
      * @see Operation.createCustomContract
-     * @see Operation.createStellarAssetContract
+     * @see Operation.createDigitalWorldAssetContract
      * @see Operation.uploadContractWasm
      */
     call(method, ...params) {
@@ -40747,7 +40747,7 @@
   class ScInt extends XdrLargeInt {
     /**
      * @param value - a single, integer-like value which will
-     *    be interpreted in the smallest appropriate XDR type supported by Stellar
+     *    be interpreted in the smallest appropriate XDR type supported by Digital World
      *    (64, 128, or 256 bit integer values). signed values are supported, though
      *    they are sanity-checked against `opts.type`. if you need 32-bit values,
      *    you can construct them directly without needing this wrapper, e.g.
@@ -43717,7 +43717,7 @@ ${value}`, dataLines++;
     return doc && typeof doc == "object" && "baseURI" in doc && typeof doc.baseURI == "string" ? doc.baseURI : void 0;
   }
 
-  const version$1 = "16.0.0";
+  const version$1 = "16.0.1";
   const SERVER_TIME_MAP = {};
   function toSeconds(ms) {
     return Math.floor(ms / 1e3);
@@ -45644,7 +45644,7 @@ ${value}`, dataLines++;
     Api2.isSimulationRaw = isSimulationRaw;
   })(Api || (Api = {}));
 
-  const version = "16.0.0";
+  const version = "16.0.1";
   function createHttpClient(headers) {
     return create({
       headers: {
@@ -46015,7 +46015,7 @@ ${value}`, dataLines++;
       }
     }
     /**
-     * Fetch a minimal set of current info about a Stellar account.
+     * Fetch a minimal set of current info about a Digital World account.
      *
      * Needed to get the current sequence number for the account so you can build
      * a successful transaction with {@link TransactionBuilder}.
@@ -46039,7 +46039,7 @@ ${value}`, dataLines++;
       return new Account(address, entry.seqNum().toString());
     }
     /**
-     * Fetch the full account entry for a Stellar account.
+     * Fetch the full account entry for a Digital World account.
      *
      * @param address - The public address of the account to load.
      * @returns Resolves to the full on-chain account
@@ -46070,7 +46070,7 @@ ${value}`, dataLines++;
       }
     }
     /**
-     * Fetch the full trustline entry for a Stellar account.
+     * Fetch the full trustline entry for a Digital World account.
      *
      * @param account - The public address of the account whose trustline it is
      * @param asset - The trustline's asset
@@ -46110,7 +46110,7 @@ ${value}`, dataLines++;
       }
     }
     /**
-     * Fetch the full claimable balance entry for a Stellar account.
+     * Fetch the full claimable balance entry for a Digital World account.
      *
      * @param id - The strkey (`B...`) or hex (`00000000abcde...`) (both
      *    IDs with and without the 000... version prefix are accepted) of the
@@ -46740,15 +46740,15 @@ ${value}`, dataLines++;
      * @example
      * ```ts
      * const contractId = 'CA3D5KRYM6CB7OWQ6TWYRR3Z4T7GNZLKERYNZGGA5SOAOPIFY6YQGAXE';
-     * const contract = new StellarSdk.Contract(contractId);
+     * const contract = new DigitalWorldSdk.Contract(contractId);
      *
      * // Right now, this is just the default fee for this example.
-     * const fee = StellarSdk.BASE_FEE;
-     * const transaction = new StellarSdk.TransactionBuilder(account, { fee })
+     * const fee = DigitalWorldSdk.BASE_FEE;
+     * const transaction = new DigitalWorldSdk.TransactionBuilder(account, { fee })
      *   // Uncomment the following line to build transactions for the live network. Be
      *   // sure to also change the horizon hostname.
-     *   //.setNetworkPassphrase(StellarSdk.Networks.PUBLIC)
-     *   .setNetworkPassphrase(StellarSdk.Networks.FUTURENET)
+     *   //.setNetworkPassphrase(DigitalWorldSdk.Networks.PUBLIC)
+     *   .setNetworkPassphrase(DigitalWorldSdk.Networks.FUTURENET)
      *   .setTimeout(30) // valid for the next 30s
      *   // Add an operation to call increment() on the contract
      *   .addOperation(contract.call("increment"))
@@ -46824,15 +46824,15 @@ ${value}`, dataLines++;
      * @example
      * ```ts
      * const contractId = 'CA3D5KRYM6CB7OWQ6TWYRR3Z4T7GNZLKERYNZGGA5SOAOPIFY6YQGAXE';
-     * const contract = new StellarSdk.Contract(contractId);
+     * const contract = new DigitalWorldSdk.Contract(contractId);
      *
      * // Right now, this is just the default fee for this example.
-     * const fee = StellarSdk.BASE_FEE;
-     * const transaction = new StellarSdk.TransactionBuilder(account, { fee })
+     * const fee = DigitalWorldSdk.BASE_FEE;
+     * const transaction = new DigitalWorldSdk.TransactionBuilder(account, { fee })
      *   // Uncomment the following line to build transactions for the live network. Be
      *   // sure to also change the horizon hostname.
-     *   //.setNetworkPassphrase(StellarSdk.Networks.PUBLIC)
-     *   .setNetworkPassphrase(StellarSdk.Networks.FUTURENET)
+     *   //.setNetworkPassphrase(DigitalWorldSdk.Networks.PUBLIC)
+     *   .setNetworkPassphrase(DigitalWorldSdk.Networks.FUTURENET)
      *   .setTimeout(30) // valid for the next 30s
      *   // Add an operation to call increment() on the contract
      *   .addOperation(contract.call("increment"))
@@ -46843,8 +46843,8 @@ ${value}`, dataLines++;
      * // Sign this transaction with the secret key
      * // NOTE: signing is transaction is network specific. Test network transactions
      * // won't work in the public network. To switch networks, use the Network object
-     * // as explained above (look for StellarSdk.Network).
-     * const sourceKeypair = StellarSdk.Keypair.fromSecret(sourceSecretKey);
+     * // as explained above (look for DigitalWorldSdk.Network).
+     * const sourceKeypair = DigitalWorldSdk.Keypair.fromSecret(sourceSecretKey);
      * preparedTransaction.sign(sourceKeypair);
      *
      * server.sendTransaction(transaction).then(result => {
@@ -46862,7 +46862,7 @@ ${value}`, dataLines++;
       return assembleTransaction(tx, simResponse).build();
     }
     /**
-     * Submit a real transaction to the Stellar network.
+     * Submit a real transaction to the Digital World network.
      *
      * Unlike Horizon, RPC does not wait for transaction completion. It
      * simply validates the transaction and enqueues it. Clients should call
@@ -46879,15 +46879,15 @@ ${value}`, dataLines++;
      * @example
      * ```ts
      * const contractId = 'CA3D5KRYM6CB7OWQ6TWYRR3Z4T7GNZLKERYNZGGA5SOAOPIFY6YQGAXE';
-     * const contract = new StellarSdk.Contract(contractId);
+     * const contract = new DigitalWorldSdk.Contract(contractId);
      *
      * // Right now, this is just the default fee for this example.
-     * const fee = StellarSdk.BASE_FEE;
-     * const transaction = new StellarSdk.TransactionBuilder(account, { fee })
+     * const fee = DigitalWorldSdk.BASE_FEE;
+     * const transaction = new DigitalWorldSdk.TransactionBuilder(account, { fee })
      *   // Uncomment the following line to build transactions for the live network. Be
      *   // sure to also change the horizon hostname.
-     *   //.setNetworkPassphrase(StellarSdk.Networks.PUBLIC)
-     *   .setNetworkPassphrase(StellarSdk.Networks.FUTURENET)
+     *   //.setNetworkPassphrase(DigitalWorldSdk.Networks.PUBLIC)
+     *   .setNetworkPassphrase(DigitalWorldSdk.Networks.FUTURENET)
      *   .setTimeout(30) // valid for the next 30s
      *   // Add an operation to call increment() on the contract
      *   .addOperation(contract.call("increment"))
@@ -46896,8 +46896,8 @@ ${value}`, dataLines++;
      * // Sign this transaction with the secret key
      * // NOTE: signing is transaction is network specific. Test network transactions
      * // won't work in the public network. To switch networks, use the Network object
-     * // as explained above (look for StellarSdk.Network).
-     * const sourceKeypair = StellarSdk.Keypair.fromSecret(sourceSecretKey);
+     * // as explained above (look for DigitalWorldSdk.Network).
+     * const sourceKeypair = DigitalWorldSdk.Keypair.fromSecret(sourceSecretKey);
      * transaction.sign(sourceKeypair);
      *
      * server.sendTransaction(transaction).then((result) => {
@@ -46953,6 +46953,11 @@ ${value}`, dataLines++;
      */
     async requestAirdrop(address, faucetUrl) {
       const account = typeof address === "string" ? address : address.accountId();
+      if (!StrKey.isValidEd25519PublicKey(account) && !StrKey.isValidContract(account)) {
+        throw new Error(
+          `Invalid address: ${account}. Expected a Digital World account (G...) or contract (C...) address.`
+        );
+      }
       faucetUrl = faucetUrl || (await this.getNetwork()).friendbotUrl;
       if (!faucetUrl) {
         throw new Error("No faucet URL configured for current network");
@@ -46990,10 +46995,10 @@ ${value}`, dataLines++;
      *
      * This method supports both account (G...) and contract (C...) addresses.
      *
-     * @param address - The address to fund. Can be either a Stellar
+     * @param address - The address to fund. Can be either a Digital World
      *    account (G...) or contract (C...) address.
      * @param faucetUrl - (optional) Optionally, an explicit faucet URL
-     *    (by default: this calls the Stellar RPC
+     *    (by default: this calls the Digital World RPC
      *    {@link rpc.Server.getNetwork | getNetwork} method to try to
      *    discover this network's faucet url).
      * @returns The transaction
@@ -47020,7 +47025,7 @@ ${value}`, dataLines++;
     async fundAddress(address, faucetUrl) {
       if (!StrKey.isValidEd25519PublicKey(address) && !StrKey.isValidContract(address)) {
         throw new Error(
-          `Invalid address: ${address}. Expected a Stellar account (G...) or contract (C...) address.`
+          `Invalid address: ${address}. Expected a Digital World account (G...) or contract (C...) address.`
         );
       }
       faucetUrl = faucetUrl || (await this.getNetwork()).friendbotUrl;
@@ -48382,7 +48387,7 @@ ${JSON.stringify(sentTransaction)}`
     MuxedAddress: {
       type: "string",
       format: "address",
-      description: "Stellar public key with M prefix combining a G address and unique ID"
+      description: "Digital World public key with M prefix combining a G address and unique ID"
     },
     ScString: {
       type: "string",
@@ -49567,13 +49572,13 @@ ${JSON.stringify(sentTransaction)}`
     if (stellarContractImports.length > 0) {
       const uniqueContractImports = Array.from(new Set(stellarContractImports));
       importLines.push(
-        `import {${uniqueContractImports.join(", ")}} from '@stellar/stellar-sdk/contract';`
+        `import {${uniqueContractImports.join(", ")}} from '@digitalworld/digital-world-sdk/contract';`
       );
     }
     if (stellarImports.length > 0) {
       const uniqueStellarImports = Array.from(new Set(stellarImports));
       importLines.push(
-        `import {${uniqueStellarImports.join(", ")}} from '@stellar/stellar-sdk';`
+        `import {${uniqueStellarImports.join(", ")}} from '@digitalworld/digital-world-sdk';`
       );
     }
     if (imports.needsBufferImport) {
@@ -49783,7 +49788,7 @@ ${indent} */
       const generatedPackageJson = {
         name: contractName.toLowerCase().replace(/[^a-z0-9-]/g, "-"),
         version: "0.0.1",
-        description: `Generated TypeScript bindings for ${contractName} Stellar contract`,
+        description: `Generated TypeScript bindings for ${contractName} Digital World contract`,
         type: "module",
         main: "dist/index.js",
         types: "dist/index.d.ts",
@@ -49791,7 +49796,7 @@ ${indent} */
           build: "tsc"
         },
         dependencies: {
-          "@stellar/stellar-sdk": `^${"16.0.0"}`,
+          "@stellar/stellar-sdk": `^${"16.0.1"}`,
           buffer: "6.0.3"
         },
         devDependencies: {
@@ -49855,7 +49860,7 @@ ${indent} */
       const readme = [
         `# ${contractName} Contract Bindings`,
         "",
-        `TypeScript bindings for the ${contractName} Stellar smart contract.`,
+        `TypeScript bindings for the ${contractName} Digital World smart contract.`,
         "",
         "## Installation",
         "",
@@ -49892,7 +49897,7 @@ ${indent} */
         "- `tsconfig.json` - TypeScript configuration",
         "- `package.json` - NPM package configuration",
         "",
-        "This package was generated using the Js-Stellar-SDK contract binding generator."
+        "This package was generated using the Digital World JS SDK contract binding generator."
       ].join("\n");
       return readme;
     }
@@ -50247,7 +50252,7 @@ export class Client extends ContractClient {
       throw new WasmFetchError("Failed to fetch WASM from hash", error);
     }
   }
-  function isStellarAssetContract(instance) {
+  function isDigitalWorldAssetContract(instance) {
     return instance.executable().switch() === types.ContractExecutableType.contractExecutableStellarAsset();
   }
   async function fetchWasmFromContract(server, contractAddress) {
@@ -50263,7 +50268,7 @@ export class Client extends ContractClient {
       }
       const contractData = entry.val.contractData();
       const instance = contractData.val().instance();
-      if (isStellarAssetContract(instance)) {
+      if (isDigitalWorldAssetContract(instance)) {
         return { type: "stellar-asset-contract" };
       }
       const wasmHash = instance.executable().wasmHash();
@@ -50364,12 +50369,12 @@ export class Client extends ContractClient {
     /**
      * Creates a BindingGenerator by fetching WASM from the network using its hash.
      *
-     * Retrieves the WASM bytecode from Stellar RPC using the WASM hash,
+     * Retrieves the WASM bytecode from Digital World RPC using the WASM hash,
      * then parses the contract specification from it. Useful when you know
      * the hash of an installed WASM but don't have the binary locally.
      *
      * @param wasmHash - The hex-encoded hash of the installed WASM blob
-     * @param rpcServer - The Stellar RPC server instance
+     * @param rpcServer - The Digital World RPC server instance
      * @returns A Promise resolving to a new BindingGenerator instance
      * @throws If the WASM cannot be fetched or doesn't contain a valid spec
      *
@@ -50393,11 +50398,11 @@ export class Client extends ContractClient {
      * Creates a BindingGenerator by fetching contract info from a deployed contract ID.
      *
      * Retrieves the contract's WASM from the network using the contract ID,
-     * then parses the specification. If the contract is a Stellar Asset Contract (SAC),
+     * then parses the specification. If the contract is a Digital World Asset Contract (SAC),
      * returns a generator with the standard SAC specification.
      *
      * @param contractId - The contract ID (C... address) of the deployed contract
-     * @param rpcServer - The Stellar RPC server instance
+     * @param rpcServer - The Digital World RPC server instance
      * @returns A Promise resolving to a new BindingGenerator instance
      * @throws If the contract cannot be found or fetched
      *