@ocap/client 1.25.3 → 1.25.5

package/docs/how-to-guides-manage-tokens.ja.md

@@ -0,0 +1,179 @@
+# トークンを管理する
+
+このガイドでは、OCAP Client を使用してファンジブルトークンを管理するための手順を詳しく説明します。トークンの設計図として機能するトークンファクトリーを設定し、それを使用してミント（新しいトークンの作成）およびバーン（既存のトークンの破棄）する方法を学びます。これらの操作は、アプリケーション内で独自の経済システムを構築・管理する上で基本となります。
+
+トークンをミントした後は、アカウント間で転送できます。そのプロセスの詳細については、[トークンとNFTの転送](./how-to-guides-transfer-tokens-and-nfts.md)ガイドを参照してください。
+
+## トークンファクトリーを作成する
+
+トークンファクトリーは、名前、シンボル、供給メカニズムなど、ファンジブルトークンのプロパティとルールを定義するスマートコントラクトです。また、ミントとバーンのプロセスも管理します。新しいトークンを流通させるには、まずファクトリーを作成する必要があります。
+
+`createTokenFactory` メソッドは、新しいトークンファクトリーをブロックチェーンにデプロイします。
+
+### パラメータ
+<x-field-group>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="トランザクションに署名するために使用される、ファクトリー所有者のウォレットオブジェクト。"></x-field>
+  <x-field data-name="token" data-type="object" data-required="true" data-desc="作成されるトークンのプロパティを定義するオブジェクト。">
+    <x-field data-name="name" data-type="string" data-required="true" data-desc="トークンのフルネーム（例：'My Awesome Token'）。"></x-field>
+    <x-field data-name="symbol" data-type="string" data-required="true" data-desc="トークンのティッカーシンボル（例：'MAT'）。"></x-field>
+    <x-field data-name="decimal" data-type="number" data-required="true" data-desc="トークンがサポートする小数点以下の桁数。"></x-field>
+    <x-field data-name="description" data-type="string" data-required="false" data-desc="トークンの簡単な説明。"></x-field>
+    <x-field data-name="icon" data-type="string" data-required="false" data-desc="トークンのアイコンへのURL。"></x-field>
+    <x-field data-name="maxTotalSupply" data-type="number" data-required="false" data-desc="これまでにミントできる最大総供給量。"></x-field>
+  </x-field>
+  <x-field data-name="curve" data-type="object" data-required="false" data-desc="トークンの価格をプログラムで制御するボンディングカーブの設定。省略した場合、ミント/バーンはリザーブトークンに結び付けられません。">
+    <x-field data-name="basePrice" data-type="number" data-required="false" data-desc="リザーブ通貨でのトークンの基本価格。"></x-field>
+    <x-field data-name="fixedPrice" data-type="number" data-required="false" data-desc="動的なカーブを使用しない場合のトークンの固定価格。"></x-field>
+    <x-field data-name="slope" data-type="number" data-required="false" data-desc="ボンディングカーブの傾きで、その急勾配を決定します。"></x-field>
+  </x-field>
+  <x-field data-name="feeRate" data-type="number" data-default="0" data-required="false" data-desc="ミントおよびバーン操作の手数料率（ベーシスポイント単位）。"></x-field>
+  <x-field data-name="data" data-type="object" data-required="false" data-desc="トークンファクトリーに添付するオプションのカスタムデータ。"></x-field>
+</x-field-group>
+
+### 戻り値
+
+トランザクションハッシュと新しく作成されたトークンファクトリーのアドレスを含む配列に解決されるプロミスを返します。
+
+<x-field-group>
+  <x-field data-name="[0]" data-type="string" data-desc="ファクトリー作成のトランザクションハッシュ。"></x-field>
+  <x-field data-name="[1]" data-type="string" data-desc="新しいトークンファクトリーのアドレス。"></x-field>
+</x-field-group>
+
+### 例
+
+```javascript Create a Token Factory icon=logos:javascript
+import Client from '@ocap/client';
+import Wallet from '@ocap/wallet';
+
+const endpoint = 'https://beta.abtnetwork.io/api';
+const client = new Client(endpoint);
+const wallet = Wallet.fromRandom();
+
+// まず、ウォレットに資金があることを確認します。テストトークンはフォーセットから入手できます：
+// https://faucet.abtnetwork.io/
+
+async function createFactory() {
+  try {
+    const [hash, factoryAddress] = await client.createTokenFactory({
+      wallet,
+      token: {
+        name: 'My Game Coin',
+        symbol: 'MGC',
+        decimal: 18,
+        description: 'The official currency for My Awesome Game.',
+        maxTotalSupply: 1000000,
+      },
+      feeRate: 100, // 1%の手数料
+    });
+
+    console.log('トークンファクトリーが正常に作成されました！');
+    console.log('トランザクションハッシュ:', hash);
+    console.log('ファクトリーアドレス:', factoryAddress);
+    return factoryAddress;
+  } catch (error) {
+    console.error('トークンファクトリーの作成中にエラーが発生しました:', error);
+  }
+}
+
+createFactory();
+```
+
+## トークンをミントする
+
+ミントとは、新しいトークンを作成して総供給量に追加するプロセスです。これはトークンファクトリーを通じて行われます。ファクトリーがボンディングカーブで設定されている場合、ミントにはリザーブトークンでの支払いが必要になります。
+
+`mintToken` メソッドは、ファクトリーから指定された量のトークンをミントするトランザクションを開始します。
+
+### パラメータ
+<x-field-group>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="ミント操作に資金を提供し、トランザクションに署名するウォレット。"></x-field>
+  <x-field data-name="tokenFactory" data-type="string" data-required="true" data-desc="ミント元となるトークンファクトリーのアドレス。"></x-field>
+  <x-field data-name="amount" data-type="number" data-required="true" data-desc="ミントするトークンの数量。"></x-field>
+  <x-field data-name="receiver" data-type="string" data-required="true" data-desc="新しくミントされたトークンを受け取るアドレス。"></x-field>
+  <x-field data-name="maxReserve" data-type="number" data-required="true" data-desc="ウォレットが支払う意思のあるリザーブトークンの最大量。これはスリッページ保護メカニズムとして機能します。"></x-field>
+  <x-field data-name="data" data-type="object" data-required="false" data-desc="ミントトランザクションに添付するオプションのカスタムデータ。"></x-field>
+</x-field-group>
+
+### 戻り値
+
+トランザクションハッシュに解決されるプロミスを返します。
+
+<x-field data-name="hash" data-type="string" data-desc="ミント操作のトランザクションハッシュ。"></x-field>
+
+### 例
+
+```javascript Mint Tokens from a Factory icon=logos:javascript
+async function mintNewTokens(factoryAddress) {
+  try {
+    const hash = await client.mintToken({
+      wallet,
+      tokenFactory: factoryAddress,
+      amount: 5000,
+      receiver: wallet.address, // 自身のウォレットにトークンをミントする
+      maxReserve: 10, // 支払うリザーブトークンの最大値。ボンディングカーブの価格に基づいて調整してください。
+    });
+
+    console.log('トークンが正常にミントされました！');
+    console.log('トランザクションハッシュ:', hash);
+  } catch (error) {
+    console.error('トークンのミント中にエラーが発生しました:', error);
+  }
+}
+
+// `factoryAddress` が createFactory の例から利用可能であると仮定
+// const factoryAddress = '...'; 
+// mintNewTokens(factoryAddress);
+```
+
+## トークンをバーンする
+
+バーンはミントの反対で、トークンを流通から永久に削除します。トークンファクトリーがボンディングカーブを使用している場合、トークンをバーンすると、ユーザーに比例した量のリザーブ通貨が返されます。
+
+`burnToken` メソッドがこのプロセスを開始します。
+
+### パラメータ
+<x-field-group>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="バーンされるトークンを保持し、トランザクションに署名するウォレット。"></x-field>
+  <x-field data-name="tokenFactory" data-type="string" data-required="true" data-desc="トークンファクトリーのアドレス。"></x-field>
+  <x-field data-name="amount" data-type="number" data-required="true" data-desc="バーンするトークンの数量。"></x-field>
+  <x-field data-name="receiver" data-type="string" data-required="true" data-desc="見返りとしてリザーブトークンを受け取るアドレス。"></x-field>
+  <x-field data-name="minReserve" data-type="number" data-required="true" data-desc="ウォレットが受け取ると期待するリザーブトークンの最小量。これは価格の滑りから保護します。"></x-field>
+  <x-field data-name="data" data-type="object" data-required="false" data-desc="バーントランザクションに添付するオプションのカスタムデータ。"></x-field>
+</x-field-group>
+
+### 戻り値
+
+トランザクションハッシュに解決されるプロミスを返します。
+
+<x-field data-name="hash" data-type="string" data-desc="バーン操作のトランザクションハッシュ。"></x-field>
+
+### 例
+
+```javascript Burn Tokens icon=logos:javascript
+async function burnExistingTokens(factoryAddress) {
+  try {
+    const hash = await client.burnToken({
+      wallet,
+      tokenFactory: factoryAddress,
+      amount: 1000,
+      receiver: wallet.address, // 自身のウォレットにリザーブトークンを受け取る
+      minReserve: 1, // 受け取るリザーブトークンの最小値。ボンディングカーブの価格に基づいて調整してください。
+    });
+
+    console.log('トークンが正常にバーンされました！');
+    console.log('トランザクションハッシュ:', hash);
+  } catch (error) {
+    console.error('トークンのバーン中にエラーが発生しました:', error);
+  }
+}
+
+// `factoryAddress` が createFactory の例から利用可能であると仮定
+// const factoryAddress = '...'; 
+// burnExistingTokens(factoryAddress);
+```
+
+## まとめ
+
+このガイドでは、ファンジブルトークンを管理するための完全なライフサイクル（ファクトリーの作成、新しいトークンのミント、供給を減らすためのバーン）を学びました。これらの強力なプリミティブにより、OCAP プラットフォーム上で高度な経済システムを構築できます。
+
+トークンの作成方法を学んだので、次のステップはトークンの移動方法を学ぶことです。[トークンとNFTの転送](./how-to-guides-transfer-tokens-and-nfts.md)ガイドでその方法を確認してください。

package/docs/how-to-guides-manage-tokens.md

@@ -0,0 +1,179 @@
+# Manage Tokens
+
+This guide provides step-by-step instructions for managing fungible tokens using the OCAP Client. You will learn how to set up a token factory, which acts as a blueprint for your token, and then use it to mint (create new tokens) and burn (destroy existing tokens). These operations are fundamental to creating and managing custom economies within your application.
+
+Once you have minted tokens, you can transfer them between accounts. For more details on that process, please see the [Transfer Tokens and NFTs](./how-to-guides-transfer-tokens-and-nfts.md) guide.
+
+## Create a Token Factory
+
+A token factory is a smart contract that defines the properties and rules of a fungible token, such as its name, symbol, and supply mechanics. It also governs the process of minting and burning. Creating a factory is the first step before any new tokens can be brought into circulation.
+
+The `createTokenFactory` method deploys a new token factory to the blockchain.
+
+### Parameters
+<x-field-group>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="The wallet object of the factory owner, used to sign the transaction."></x-field>
+  <x-field data-name="token" data-type="object" data-required="true" data-desc="An object defining the properties of the token to be created.">
+    <x-field data-name="name" data-type="string" data-required="true" data-desc="The full name of the token (e.g., 'My Awesome Token')."></x-field>
+    <x-field data-name="symbol" data-type="string" data-required="true" data-desc="The token's ticker symbol (e.g., 'MAT')."></x-field>
+    <x-field data-name="decimal" data-type="number" data-required="true" data-desc="The number of decimal places the token supports."></x-field>
+    <x-field data-name="description" data-type="string" data-required="false" data-desc="A brief description of the token."></x-field>
+    <x-field data-name="icon" data-type="string" data-required="false" data-desc="URL to an icon for the token."></x-field>
+    <x-field data-name="maxTotalSupply" data-type="number" data-required="false" data-desc="The maximum total supply that can ever be minted."></x-field>
+  </x-field>
+  <x-field data-name="curve" data-type="object" data-required="false" data-desc="Configuration for a bonding curve, which programmatically controls the token's price. If omitted, minting/burning is not tied to a reserve token.">
+    <x-field data-name="basePrice" data-type="number" data-required="false" data-desc="The base price for the token in the reserve currency."></x-field>
+    <x-field data-name="fixedPrice" data-type="number" data-required="false" data-desc="A fixed price for the token, if not using a dynamic curve."></x-field>
+    <x-field data-name="slope" data-type="number" data-required="false" data-desc="The slope of the bonding curve, determining its steepness."></x-field>
+  </x-field>
+  <x-field data-name="feeRate" data-type="number" data-default="0" data-required="false" data-desc="The fee rate (in basis points) for minting and burning operations."></x-field>
+  <x-field data-name="data" data-type="object" data-required="false" data-desc="Optional custom data to attach to the token factory."></x-field>
+</x-field-group>
+
+### Returns
+
+Returns a promise that resolves to an array containing the transaction hash and the address of the newly created token factory.
+
+<x-field-group>
+  <x-field data-name="[0]" data-type="string" data-desc="The transaction hash for the factory creation."></x-field>
+  <x-field data-name="[1]" data-type="string" data-desc="The address of the new token factory."></x-field>
+</x-field-group>
+
+### Example
+
+```javascript Create a Token Factory icon=logos:javascript
+import Client from '@ocap/client';
+import Wallet from '@ocap/wallet';
+
+const endpoint = 'https://beta.abtnetwork.io/api';
+const client = new Client(endpoint);
+const wallet = Wallet.fromRandom();
+
+// First, ensure the wallet has funds. You can get test tokens from a faucet:
+// https://faucet.abtnetwork.io/
+
+async function createFactory() {
+  try {
+    const [hash, factoryAddress] = await client.createTokenFactory({
+      wallet,
+      token: {
+        name: 'My Game Coin',
+        symbol: 'MGC',
+        decimal: 18,
+        description: 'The official currency for My Awesome Game.',
+        maxTotalSupply: 1000000,
+      },
+      feeRate: 100, // 1% fee
+    });
+
+    console.log('Token factory created successfully!');
+    console.log('Transaction Hash:', hash);
+    console.log('Factory Address:', factoryAddress);
+    return factoryAddress;
+  } catch (error) {
+    console.error('Error creating token factory:', error);
+  }
+}
+
+createFactory();
+```
+
+## Mint Tokens
+
+Minting is the process of creating new tokens and adding them to the total supply. This is done through a token factory. If the factory was configured with a bonding curve, minting will require a payment in the reserve token.
+
+The `mintToken` method initiates a transaction to mint a specified amount of tokens from a factory.
+
+### Parameters
+<x-field-group>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="The wallet funding the mint operation and signing the transaction."></x-field>
+  <x-field data-name="tokenFactory" data-type="string" data-required="true" data-desc="The address of the token factory to mint from."></x-field>
+  <x-field data-name="amount" data-type="number" data-required="true" data-desc="The quantity of tokens to mint."></x-field>
+  <x-field data-name="receiver" data-type="string" data-required="true" data-desc="The address that will receive the newly minted tokens."></x-field>
+  <x-field data-name="maxReserve" data-type="number" data-required="true" data-desc="The maximum amount of the reserve token the wallet is willing to spend. This acts as a slippage protection mechanism."></x-field>
+  <x-field data-name="data" data-type="object" data-required="false" data-desc="Optional custom data to attach to the mint transaction."></x-field>
+</x-field-group>
+
+### Returns
+
+Returns a promise that resolves to the transaction hash.
+
+<x-field data-name="hash" data-type="string" data-desc="The transaction hash for the mint operation."></x-field>
+
+### Example
+
+```javascript Mint Tokens from a Factory icon=logos:javascript
+async function mintNewTokens(factoryAddress) {
+  try {
+    const hash = await client.mintToken({
+      wallet,
+      tokenFactory: factoryAddress,
+      amount: 5000,
+      receiver: wallet.address, // Mint tokens to our own wallet
+      maxReserve: 10, // Max reserve token to pay. Adjust based on bonding curve price.
+    });
+
+    console.log('Tokens minted successfully!');
+    console.log('Transaction Hash:', hash);
+  } catch (error) {
+    console.error('Error minting tokens:', error);
+  }
+}
+
+// Assuming `factoryAddress` is available from the createFactory example
+// const factoryAddress = '...'; 
+// mintNewTokens(factoryAddress);
+```
+
+## Burn Tokens
+
+Burning is the opposite of minting; it permanently removes tokens from circulation. If the token factory uses a bonding curve, burning tokens will return a proportional amount of the reserve currency to the user.
+
+The `burnToken` method initiates this process.
+
+### Parameters
+<x-field-group>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="The wallet that holds the tokens to be burned and will sign the transaction."></x-field>
+  <x-field data-name="tokenFactory" data-type="string" data-required="true" data-desc="The address of the token factory."></x-field>
+  <x-field data-name="amount" data-type="number" data-required="true" data-desc="The quantity of tokens to burn."></x-field>
+  <x-field data-name="receiver" data-type="string" data-required="true" data-desc="The address that will receive the reserve tokens in return."></x-field>
+  <x-field data-name="minReserve" data-type="number" data-required="true" data-desc="The minimum amount of the reserve token the wallet expects to receive. This protects against price slippage."></x-field>
+  <x-field data-name="data" data-type="object" data-required="false" data-desc="Optional custom data to attach to the burn transaction."></x-field>
+</x-field-group>
+
+### Returns
+
+Returns a promise that resolves to the transaction hash.
+
+<x-field data-name="hash" data-type="string" data-desc="The transaction hash for the burn operation."></x-field>
+
+### Example
+
+```javascript Burn Tokens icon=logos:javascript
+async function burnExistingTokens(factoryAddress) {
+  try {
+    const hash = await client.burnToken({
+      wallet,
+      tokenFactory: factoryAddress,
+      amount: 1000,
+      receiver: wallet.address, // Receive reserve tokens back to our own wallet
+      minReserve: 1, // Min reserve token to receive. Adjust based on bonding curve price.
+    });
+
+    console.log('Tokens burned successfully!');
+    console.log('Transaction Hash:', hash);
+  } catch (error) {
+    console.error('Error burning tokens:', error);
+  }
+}
+
+// Assuming `factoryAddress` is available from the createFactory example
+// const factoryAddress = '...'; 
+// burnExistingTokens(factoryAddress);
+```
+
+## Summary
+
+In this guide, you've learned the complete lifecycle for managing fungible tokens: creating a factory, minting new tokens into existence, and burning them to reduce the supply. These powerful primitives allow you to build sophisticated economic systems on the OCAP platform.
+
+Now that you know how to create tokens, the next logical step is to learn how to move them around. Head over to the [Transfer Tokens and NFTs](./how-to-guides-transfer-tokens-and-nfts.md) guide to see how it's done.

package/docs/how-to-guides-manage-tokens.zh-TW.md

@@ -0,0 +1,179 @@
+# 管理代幣
+
+本指南提供使用 OCAP Client 管理同質化代幣的逐步說明。您將學習如何設定代幣工廠（作為您代幣的藍圖），然後用它來鑄造（創建新代幣）和銷毀（摧毀現有代幣）。這些操作是在您的應用程式中創建和管理自訂經濟體的基礎。
+
+一旦鑄造了代幣，您就可以在帳戶之間轉移它們。有關該過程的更多詳細資訊，請參閱 [轉移代幣和 NFT](./how-to-guides-transfer-tokens-and-nfts.md) 指南。
+
+## 建立代幣工廠
+
+代幣工廠是一種智能合約，它定義了同質化代幣的屬性和規則，例如其名稱、符號和供應機制。它還管理鑄造和銷毀的過程。建立工廠是任何新代幣進入流通前的第一步。
+
+`createTokenFactory` 方法將一個新的代幣工廠部署到區塊鏈上。
+
+### 參數
+<x-field-group>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="工廠所有者的錢包物件，用於簽署交易。"></x-field>
+  <x-field data-name="token" data-type="object" data-required="true" data-desc="一個定義要創建的代幣屬性的物件。">
+    <x-field data-name="name" data-type="string" data-required="true" data-desc="代幣的全名（例如，'My Awesome Token'）。"></x-field>
+    <x-field data-name="symbol" data-type="string" data-required="true" data-desc="代幣的股票代碼（例如，'MAT'）。"></x-field>
+    <x-field data-name="decimal" data-type="number" data-required="true" data-desc="代幣支援的小數位數。"></x-field>
+    <x-field data-name="description" data-type="string" data-required="false" data-desc="代幣的簡要描述。"></x-field>
+    <x-field data-name="icon" data-type="string" data-required="false" data-desc="代幣圖示的 URL。"></x-field>
+    <x-field data-name="maxTotalSupply" data-type="number" data-required="false" data-desc="可鑄造的最大總供應量。"></x-field>
+  </x-field>
+  <x-field data-name="curve" data-type="object" data-required="false" data-desc="聯合曲線的設定，以程式化方式控制代幣價格。如果省略，鑄造/銷毀將不與儲備代幣掛鉤。">
+    <x-field data-name="basePrice" data-type="number" data-required="false" data-desc="代幣以儲備貨幣計價的基礎價格。"></x-field>
+    <x-field data-name="fixedPrice" data-type="number" data-required="false" data-desc="代幣的固定價格，如果不使用動態曲線。"></x-field>
+    <x-field data-name="slope" data-type="number" data-required="false" data-desc="聯合曲線的斜率，決定其陡峭程度。"></x-field>
+  </x-field>
+  <x-field data-name="feeRate" data-type="number" data-default="0" data-required="false" data-desc="鑄造和銷毀操作的費率（以基點為單位）。"></x-field>
+  <x-field data-name="data" data-type="object" data-required="false" data-desc="可選的自訂資料，附加到代幣工廠。"></x-field>
+</x-field-group>
+
+### 返回值
+
+返回一個解析為包含交易雜湊值和新創建代幣工廠地址的陣列的 promise。
+
+<x-field-group>
+  <x-field data-name="[0]" data-type="string" data-desc="工廠創建的交易雜湊值。"></x-field>
+  <x-field data-name="[1]" data-type="string" data-desc="新代幣工廠的地址。"></x-field>
+</x-field-group>
+
+### 範例
+
+```javascript Create a Token Factory icon=logos:javascript
+import Client from '@ocap/client';
+import Wallet from '@ocap/wallet';
+
+const endpoint = 'https://beta.abtnetwork.io/api';
+const client = new Client(endpoint);
+const wallet = Wallet.fromRandom();
+
+// 首先，確保錢包有資金。您可以從水龍頭獲取測試代幣：
+// https://faucet.abtnetwork.io/
+
+async function createFactory() {
+  try {
+    const [hash, factoryAddress] = await client.createTokenFactory({
+      wallet,
+      token: {
+        name: 'My Game Coin',
+        symbol: 'MGC',
+        decimal: 18,
+        description: 'The official currency for My Awesome Game.',
+        maxTotalSupply: 1000000,
+      },
+      feeRate: 100, // 1% 手續費
+    });
+
+    console.log('代幣工廠建立成功！');
+    console.log('交易雜湊值：', hash);
+    console.log('工廠地址：', factoryAddress);
+    return factoryAddress;
+  } catch (error) {
+    console.error('建立代幣工廠時出錯：', error);
+  }
+}
+
+createFactory();
+```
+
+## 鑄造代幣
+
+鑄造是創建新代幣並將其加入總供應量的過程。這是透過代幣工廠完成的。如果工廠配置了聯合曲線，鑄造將需要支付儲備代幣。
+
+`mintToken` 方法會啟動一個交易，從工廠鑄造指定數量的代幣。
+
+### 參數
+<x-field-group>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="為鑄造操作提供資金並簽署交易的錢包。"></x-field>
+  <x-field data-name="tokenFactory" data-type="string" data-required="true" data-desc="要從中鑄造代幣的代幣工廠地址。"></x-field>
+  <x-field data-name="amount" data-type="number" data-required="true" data-desc="要鑄造的代幣數量。"></x-field>
+  <x-field data-name="receiver" data-type="string" data-required="true" data-desc="將接收新鑄造代幣的地址。"></x-field>
+  <x-field data-name="maxReserve" data-type="number" data-required="true" data-desc="錢包願意花費的儲備代幣最大數量。這可作為一種滑價保護機制。"></x-field>
+  <x-field data-name="data" data-type="object" data-required="false" data-desc="可選的自訂資料，附加到鑄造交易中。"></x-field>
+</x-field-group>
+
+### 返回值
+
+返回一個解析為交易雜湊值的 promise。
+
+<x-field data-name="hash" data-type="string" data-desc="鑄造操作的交易雜湊值。"></x-field>
+
+### 範例
+
+```javascript Mint Tokens from a Factory icon=logos:javascript
+async function mintNewTokens(factoryAddress) {
+  try {
+    const hash = await client.mintToken({
+      wallet,
+      tokenFactory: factoryAddress,
+      amount: 5000,
+      receiver: wallet.address, // 將代幣鑄造到我們自己的錢包
+      maxReserve: 10, // 要支付的最大儲備代幣。根據聯合曲線價格進行調整。
+    });
+
+    console.log('代幣鑄造成功！');
+    console.log('交易雜湊值：', hash);
+  } catch (error) {
+    console.error('鑄造代幣時出錯：', error);
+  }
+}
+
+// 假設 `factoryAddress` 可從 createFactory 範例中獲得
+// const factoryAddress = '...'; 
+// mintNewTokens(factoryAddress);
+```
+
+## 銷毀代幣
+
+銷毀與鑄造相反；它會永久地將代幣從流通中移除。如果代幣工廠使用聯合曲線，銷毀代幣將按比例返還儲備貨幣給用戶。
+
+`burnToken` 方法會啟動此過程。
+
+### 參數
+<x-field-group>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="持有要銷毀的代幣並將簽署交易的錢包。"></x-field>
+  <x-field data-name="tokenFactory" data-type="string" data-required="true" data-desc="代幣工廠的地址。"></x-field>
+  <x-field data-name="amount" data-type="number" data-required="true" data-desc="要銷毀的代幣數量。"></x-field>
+  <x-field data-name="receiver" data-type="string" data-required="true" data-desc="將接收返還的儲備代幣的地址。"></x-field>
+  <x-field data-name="minReserve" data-type="number" data-required="true" data-desc="錢包預期收到的最少儲備代幣數量。這可以防止價格滑動。"></x-field>
+  <x-field data-name="data" data-type="object" data-required="false" data-desc="可選的自訂資料，附加到銷毀交易中。"></x-field>
+</x-field-group>
+
+### 返回值
+
+返回一個解析為交易雜湊值的 promise。
+
+<x-field data-name="hash" data-type="string" data-desc="銷毀操作的交易雜湊值。"></x-field>
+
+### 範例
+
+```javascript Burn Tokens icon=logos:javascript
+async function burnExistingTokens(factoryAddress) {
+  try {
+    const hash = await client.burnToken({
+      wallet,
+      tokenFactory: factoryAddress,
+      amount: 1000,
+      receiver: wallet.address, // 將儲備代幣接收回我們自己的錢包
+      minReserve: 1, // 要接收的最小儲備代幣。根據聯合曲線價格進行調整。
+    });
+
+    console.log('代幣銷毀成功！');
+    console.log('交易雜湊值：', hash);
+  } catch (error) {
+    console.error('銷毀代幣時出錯：', error);
+  }
+}
+
+// 假設 `factoryAddress` 可從 createFactory 範例中獲得
+// const factoryAddress = '...'; 
+// burnExistingTokens(factoryAddress);
+```
+
+## 總結
+
+在本指南中，您學習了管理同質化代幣的完整生命週期：建立工廠、鑄造新代幣使其存在，以及銷毀它們以減少供應。這些強大的基礎功能讓您可以在 OCAP 平台上建構複雜的經濟系統。
+
+既然您知道了如何創建代幣，接下來合乎邏輯的一步就是學習如何轉移它們。請前往 [轉移代幣和 NFT](./how-to-guides-transfer-tokens-and-nfts.md) 指南查看如何操作。