创建链账户

生产环境

POST

/v3/account

AVATA API 文档/AVATA API 文档/AVATA v3 API 文档/链账户接口

链账户是应用方或其用户在区块链上的账户地址，用于存储和管理在区块链上所拥有的资产。
目前通过 AVATA 平台创建的区块链账户地址生成即上链，会产生一笔上链交易所需费用（0.05元/个）。建议应用方按照实际会与底层链交互的活跃用户数进行链账户创建。

请求参数

Header 参数

Content-Type

string

必需

固定值：application/json

X-Api-Key

string

必需

项目 API Key，用于 API 访问鉴权

X-Timestamp

string

必需

时间戳，1970年1月1日0点0分0秒到现在的毫秒数

X-Signature

string

必需

API 签名，算法为SHA256(Params+Timestamp+ApiSecret)

Body 参数application/json

name

string

链账户名称

可选

>= 1 字符<= 20 字符

user_id

string

钱包用户ID（⚠️ 普通项目不需传）

可选

📢 注意：如果您只是通过 Avata 服务平台创建的项目，而非与 AVATA 平台商务人员联系申请创建的钱包应用项目，可直接忽略此字段
📌 声明：此字段只针对 AVATA 平台的区块链钱包应用项目独立设置，如果您是钱包应用项目，通过区块链钱包应用给某一钱包用户创建链账户地址时，必需传入该字段。该字段值是由「创建钱包用户」接口返回。

operation_id

string

操作ID

必需

保证幂等性，避免重复请求，保证对于同一操作发起的一次请求或者多次请求的结果是一致的；由接入方生成并自行维护、针对每个 Project ID 唯一的、不超过 64 个大小写字母、数字、-、下划线的字符串组成。

>= 1 字符<= 64 字符

正则匹配:

^[a-zA-Z0-9_-]+$

示例

{
  "name": "string",
  "user_id": "string",
  "operation_id": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://apis.avata.bianjie.ai/v3/account' \
--header 'X-Api-Key;' \
--header 'X-Api-Key;' \
--header 'X-Timestamp;' \
--header 'X-Timestamp;' \
--header 'X-Signature;' \
--header 'X-Signature;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "string",
    "user_id": "string",
    "operation_id": "string"
}'

返回响应

🟢200successful operation

application/json

Body

data

object

必需

native_address

string

原生地址格式

必需

在 IRITA 底层链中，使用一种称为Bech32的地址格式来表示原生地址。Bech32是一种用于表示多种链账户地址的编码格式，其中包括「文昌链」和其他基于 IRITA 构建的区块链。
Bech32地址以特定的前缀标识符开始，后面跟着由基于Base32编码的字符组成数据部分，表示特定的公钥或其他标识符。文昌链 Bech32地址前缀是"iaa"。

hex_address

string

以太坊地址格式

必需

HEX地址通常是指以十六进制表示的区块链账户地址，特别是在 EVM 模块中使用的地址格式。HEX地址通常以"0x"开头，后面跟着40个十六进制字符，由0-9和A-F（或小写的a-f）组成。

示例

{
  "data": {
    "native_address": "string",
    "hex_address": "string"
  }
}

🟠400failed operation

修改于 2024-05-20 05:39:33

API 版本简介

批量创建链账户