跳至主要内容

ERC1155

ERC1155 資源提供與多代幣合約互動的操作。

概述​

ERC1155 是一種多代幣標準，可以在單一合約中表示同質化和非同質化代幣。

操作​

Balance Of（餘額查詢）​

取得地址特定代幣 ID 的餘額。

所需憑證：Ethereum RPC

參數：

  • Contract Address（合約地址）（必需）：ERC1155 合約地址
  • Account（帳戶）（必需）：要檢查餘額的地址
  • Token ID（代幣 ID）（必需）：要查詢的代幣 ID

輸出範例：

{
  "balance": "10"
}

範例：

{
  "balance": "10"
}

Balance Of Batch（批量餘額查詢）​

在一次呼叫中取得多個帳戶和代幣 ID 的餘額。

所需憑證：Ethereum RPC

參數：

  • Contract Address（合約地址）（必需）：ERC1155 合約地址
  • Accounts（帳戶）（必需）：地址陣列
  • Token IDs（代幣 ID）（必需）：代幣 ID 陣列

範例：

{
  "balance": "10"
}

Safe Transfer From（安全轉移）​

將單一代幣類型轉移到另一個地址。

所需憑證：Ethereum RPC、Ethereum Account

參數：

  • Contract Address（合約地址）（必需）：ERC1155 合約地址
  • From（來源）（必需）：發送者地址
  • To（接收者）（必需）：接收者地址
  • Token ID（代幣 ID）（必需）：要轉移的代幣 ID
  • Amount（數量）（必需）：要轉移的數量
  • Data（資料）（可選）：額外資料

範例：

{
  "contractAddress": "0x...",
  "from": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "to": "0x1111111254fb6c44bAC0beD2854e76F90643097d",
  "tokenId": "1",
  "amount": "10",
  "data": "0x"
}

輸出：

{
  "hash": "0x1234567890abcdef...",
  "from": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "to": "0x..."
}

Safe Batch Transfer From（批量安全轉移）​

在單一交易中轉移多種代幣類型。

所需憑證：Ethereum RPC、Ethereum Account

參數：

  • Contract Address（合約地址）（必需）：ERC1155 合約地址
  • From（來源）（必需）：發送者地址
  • To（接收者）（必需）：接收者地址
  • Token IDs（代幣 ID）（必需）：代幣 ID 陣列
  • Amounts（數量）（必需）：數量陣列
  • Data（資料）（可選）：額外資料

範例：

{
  "contractAddress": "0x...",
  "from": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "to": "0x1111111254fb6c44bAC0beD2854e76F90643097d",
  "tokenIds": ["1", "2", "3"],
  "amounts": ["10", "5", "20"],
  "data": "0x"
}

輸出：

{
  "hash": "0x1234567890abcdef...",
  "from": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "to": "0x..."
}

Set Approval For All（設定全部批准）​

批准操作者管理所有代幣。

所需憑證：Ethereum RPC、Ethereum Account

參數：

  • Contract Address（合約地址）（必需）：ERC1155 合約地址
  • Operator（操作者）（必需）：要批准的地址
  • Approved（已批准）（必需）：true 批准，false 撤銷

範例：

{
  "contractAddress": "0x...",
  "operator": "0x1111111254fb6c44bAC0beD2854e76F90643097d",
  "approved": true
}

輸出：

{
  "hash": "0x1234567890abcdef...",
  "from": "0xYourAddress...",
  "to": "0x..."
}

Is Approved For All（是否全部批准）​

檢查操作者是否被批准。

所需憑證：Ethereum RPC

參數：

  • Contract Address（合約地址）（必需）：ERC1155 合約地址
  • Owner（所有者）（必需）：所有者地址
  • Operator（操作者）（必需）：操作者地址

範例：

{
  "contractAddress": "0x...",
  "owner": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "operator": "0x1111111254fb6c44bAC0beD2854e76F90643097d"
}

輸出：

{
  "isApprovedForAll": true
}

URI​

取得代幣的元資料 URI。

所需憑證：Ethereum RPC

參數：

  • Contract Address（合約地址）（必需）：ERC1155 合約地址
  • Token ID（代幣 ID）（必需）：要查詢的代幣 ID

常見使用場景​

範例：

{
  "contractAddress": "0x...",
  "tokenId": "1"
}

輸出：

{
  "uri": "https://token-cdn-domain/{id}.json"
}

批量代幣轉移​

[Trigger] → [Safe Batch Transfer From] → [Wait For Transaction] → [通知]

檢查多個餘額​

[Schedule Trigger] → [Balance Of Batch] → [處理餘額] → [儲存]

提示​

  • 批量操作：ERC1155 擅長批量操作，減少 Gas 成本
  • 多代幣：可以表示同質化和非同質化代幣
  • 遊戲：在遊戲物品和遊戲內貨幣中很受歡迎
  • 效率：對於多個代幣，比 ERC721 更節省 Gas