Ethereum相关

查询以太坊网络

接口描述
根据网络ID查询以太坊网络详情。

权限说明
请求发起人需要具有合法的AccessKeyID和SecretAccessKey才能发起请求。

注意事项
如果请求中没有用户验证信息(即匿名访问),返回403 Forbidden,错误信息:AccessDenied

请求(Request)

  • 请求语法

    GET /v1/ethereum/network/:networkUuid HTTP/1.1
    Host: bbe.bj.baidubce.com
    x-bce-date: <x-bce-date>
    x-bce-request-id: <x-bce-request-id>
    Authorization: <Authorization>
    
  • 请求头域
    除公共头域外,无其它特殊头域。

  • 请求参数

    名称 类型 描述 是否必须
    networkUuid String 网络ID 必须

响应(Response)

  • 响应头域

除公共头域外,无其它特殊头域。

  • 响应参数

    名称 类型 描述
    networks []EthereumNetworkInfo 以太坊网络详情列表,结构具体定义见附录说明

    失败响应参考错误码部分。

示例

  • 请求示例
GET /v1/ethereum/network/f5696c47-002d-40fe-89b7-8cc202181a7f HTTP/1.1
    Host: bbe.bj.baidubce.com
    x-bce-date: 2019-01-06T06:55:42Z
    x-bce-request-id: b9485394-c7dc-3cfa-d454-57c34773d08c
    Authorization: bce-auth-v1/5fded23b03594981872fbfadaad70ef6/2019-01-06T06:55:42Z/1800/host/84bc3dd2774cf6a6276a86e0cc7680e01710a1b7cb1a87de552af581131c818f
  • 响应示例

    200
    Content-Length: 3153
    Content-Type: application/json; charset=utf-8
    Date: Fri, 04 Jan 2019 07:24:02 GMT
    
    {
        "data": {
            "networks": 
                {
                    "name": "eth-test",
                    "uuid": "f5696c47-002d-40fe-89b7-8cc202181a7f",
                    "cceClusterId": "c-EkArpGxo",
                    "networkSize": 1,
                    "chainId": 1546081113,
                    "targetGasLimit": 281474976710655,
                    "maxPeers": 25,
                    "verbosity": 9,
                    "syncMode": "full",
                    "gasPrice": 0,
                    "difficulty": 60,
                    "gasLimit": 281474976710655,
                    "genesisAccounts": [
                        {
                            "address": "0x357AF1c61B7F1075Ba97e04876D6f436C6762Df7",
                            "privateKey": "82b448480b6e4bf639fd10cb22fdd92ccdd19ec7f1245212109ed1466c5d7c90",
                            "balance": 1000000000000000000
                        }
                    ],
                    "minerAccount": [
                        {
                            "address": "0x42328C24028Bb92366039b9Cc78dcC320461Cd69",
                            "privateKey": "7746566e612dace4de5e143347bb33620d299ba7fd9159cd625d808b79a2c4ed",
                            "balance": 1000000000000000000
                        }
                    ],
                    "accounts": [
                        {
                            "address": "0x42328C24028Bb92366039b9Cc78dcC320461Cd69",
                            "privateKey": "7746566e612dace4de5e143347bb33620d299ba7fd9159cd625d808b79a2c4ed",
                            "balance": 1000000000000000000
                        }
                    ],
                    "nodeList": {
                        "gethNodes": [
                            {
                                "name": "node-1",
                                "ip": "127.0.0.1",
                                "jsonrpcPort": 8545,
                                "wsrpcPort": 8546,
                                "ipcListenPort": 30303,
                                "ipcDiscoveryPort": 30303,
                                "role": "miner",
                                "desp": ""
                            }
                        ]
                    },
                    "state": "RUNNING",
                    "startTime": "2018-12-29T02:58:33+08:00",
                    "UserId": "00dc1b52d8354d9193536e4dd2c41ae6",
                    "netstatsAddress": "http://192.168.0.1",
                    "remixAddress": "http://192.168.0.1",
                    "explorerAddress": "http://192.168.0.1",
                    "jsonrpcAddress": "http://192.168.0.1",
                    "deleted": false,
                    "errorMessage": ""
                }
        }
    }
    

删除以太坊网络

接口描述
根据网络ID删除以太坊网络。

权限说明
请求发起人需要具有合法的AccessKeyID和SecretAccessKey才能发起请求。

注意事项
如果请求中没有用户验证信息(即匿名访问),返回403 Forbidden,错误信息:AccessDenied

请求(Request)

  • 请求语法

    DELETE /v1/ethereum/network/:networkUuid HTTP/1.1
    Host: bbe.bj.baidubce.com
    x-bce-date: <x-bce-date>
    x-bce-request-id: <x-bce-request-id>
    Authorization: <Authorization>
    
  • 请求头域
    除公共头域外,无其它特殊头域。

  • 请求参数

    名称 类型 描述 是否必须
    networkUuid String 网络ID 必须

响应(Response)

  • 响应头域
    除公共头域外,无其它特殊头域。

  • 响应参数
    失败响应参考错误码部分。

示例

  • 请求示例

    DELETE /v1/ethereum/network/f5696c47-002d-40fe-89b7-8cc202181a7f HTTP/1.1
    Host: bbe.bj.baidubce.com
    x-bce-date: 2019-01-06T06:55:42Z
    x-bce-request-id: b9485394-c7dc-3cfa-d454-57c34773d08c
    Authorization: bce-auth-v1/5fded23b03594981872fbfadaad70ef6/2019-01-06T06:55:42Z/1800/host/84bc3dd2774cf6a6276a86e0cc7680e01710a1b7cb1a87de552af581131c818f
    
  • 响应示例

    200
    Content-Length: 0
    Content-Type: application/json; charset=utf-8
    Date: Fri, 04 Jan 2019 10:24:02 GMT
    

获取以太坊网络部署列表

接口描述
获取用户部署的所有以太坊网络列表。

权限说明
请求发起人需要具有合法的AccessKeyID和SecretAccessKey才能发起请求。

注意事项
如果请求中没有用户验证信息(即匿名访问),返回403 Forbidden,错误信息:AccessDenied

请求(Request)

  • 请求语法

    GET /v1/ethereum/list
    Host: bbe.bj.baidubce.com
    Date: <Date>
    Authorization: <Authorization_String>
    
  • 请求头域
    除公共头域外,无其它特殊头域。

  • 请求参数

    名称 类型 描述 是否必须
    marker String 批量获取列表的查询的起始位置,是一个由系统生成的字符串
    maxKeys Integer 每页包含的最大数量,最大数量通常不超过1000,缺省值为1000
    status String bbe状态,状态间”,” 分割,可以不填写,则返回前端显示状态

响应(Response)

  • 响应头域
    除公共头域外,无其它特殊头域。

  • 响应参数

    名称 类型 描述
    marker String 标记查询的起始位置
    isTruncated boolean true表示后面还有数据,false表示已经是最后一页
    nextMarker String 获取下一页所需要传递的marker值。当isTruncated为false时,该域不出现
    maxKeys Integer 每页包含的最大数量
    result []NetworkInfo 网络详情列表,结构具体定义见附录说明

    失败响应参考错误码部分。

示例

  • 请求示例

    GET bbe.bj.baidubce.com/v1/ethereum/list HTTP/1.1
    
    content-type: application/json
    host: bbe.bj.baidubce.com
    x-bce-date: 2019-01-06T06:55:42Z
    x-bce-request-id: b9485394-c7dc-3cfa-d454-57c34773d08c
    authorization: bce-auth-v1/5fded23b03594981872fbfadaad70ef6/2019-01-06T06:55:42Z/1800/host/84bc3dd2774cf6a6276a86e0cc7680e01710a1b7cb1a87de552af581131c818f
    
  • 响应示例

    200
    Content-Length: 6171
    Content-Type: application/json; charset=utf-8
    Date: Fri, 04 Jan 2019 10:24:02 GMT
    
    {
        "nextMarker": "-1",
        "marker": "-1",
        "maxKeys": 1000,
        "isTruncated": false,
        "result": [
            {
                "blockchainUuid": "1f7833ed-e378-4108-9f71-9d110386b298",
                "clusterUuid": "c-QOUyL2yh",
                "clusterName": "lql",
                "accountId": "00dc1b52d8354d9193536e4dd2c41ae6",
                "networkUuid": "2b031568-5073-4967-bc86-bff6a242cd11",
                "networkName": "test-lql",
                "contractUuid": "",
                "chaincodeUuid": "",
                "networkType": null,
                "dappUuid": "",
                "taskUuid": "1a204bf5-f0c7-4064-85bb-3b199311fd4b",
                "createTime": 1546500733000,
                "deleteTime": 31536001000,
                "updateTime": null,
                "clusterStatus": "RUNNING",
                "taskStatus": "DONE",
                "channels": "",
                "remixUrl": null,
                "netstatsAddress": "http://10.107.245.134:8000",
                "explorerAddress": null
            }
        ]
    }
    

查询账户列表

接口描述
查询指定网络下的账户列表。

权限说明
请求发起人需要具有合法的AccessKeyID和SecretAccessKey才能发起请求。

注意事项
如果请求中没有用户验证信息(即匿名访问),返回403 Forbidden,错误信息:AccessDenied

请求(Request)

  • 请求语法

    GET /v1/ethereum/account?networkUuid=xxx HTTP/1.1
    Host: bbe.bj.baidubce.com
    x-bce-date: <x-bce-date>
    x-bce-request-id: <x-bce-request-id>
    Authorization: <Authorization>
    
  • 请求头域
    除公共头域外,无其它特殊头域。

  • 请求参数

    名称 类型 描述 是否必须
    networkUuid String 网络ID 必须

响应(Response)

  • 响应头域
    除公共头域外,无其它特殊头域。

  • 响应参数

    名称 类型 描述
    address String 以太坊账户地址
    privateKey String 以太坊账户私钥
    balance Long 以太坊账户余额

    失败响应参考错误码部分。

示例

  • 请求示例
GET /v1/ethereum/account?networkUuid=f5696c47-002d-40fe-89b7-8cc202181a7f HTTP/1.1
    Host: bbe.bj.baidubce.com
    x-bce-date: 2019-01-06T06:55:42Z
    x-bce-request-id: b9485394-c7dc-3cfa-d454-57c34773d08c
    Authorization: bce-auth-v1/5fded23b03594981872fbfadaad70ef6/2019-01-06T06:55:42Z/1800/host/84bc3dd2774cf6a6276a86e0cc7680e01710a1b7cb1a87de552af581131c818f
  • 响应示例

    200
    Content-Length: 153
    Content-Type: application/json; charset=utf-8
    Date: Fri, 04 Jan 2019 07:24:02 GMT
    
    {
        "data": {
            "accounts": [
                {
                    "address": "0x42328C24028Bb92366039b9Cc78dcC320461Cd69",
                    "privateKey": "7746566e612dace4de5e143347bb33620d299ba7fd9159cd625d808b79a2c4ed",
                    "balance": 1000000000000000000
                 }
            ]
        }
    }
    

创建新账户

接口描述
创建一个以太坊账户。

权限说明
请求发起人需要具有合法的AccessKeyID和SecretAccessKey才能发起请求。

注意事项
如果请求中没有用户验证信息(即匿名访问),返回403 Forbidden,错误信息:AccessDenied

请求(Request)

  • 请求语法

    POST /v1/ethereum/account HTTP/1.1
    Host: bbe.bj.baidubce.com
    x-bce-date: <x-bce-date>
    x-bce-request-id: <x-bce-request-id>
    Authorization: <Authorization>
    
  • 请求头域
    除公共头域外,无其它特殊头域。

  • 请求参数

    名称 类型 描述 是否必须
    networkUuid String 网络ID 必须
    balance Long 初始余额 必须

响应(Response)

  • 响应头域
    除公共头域外,无其它特殊头域。

  • 响应参数

    名称 类型 描述
    address String 以太坊账户地址
    txId String 交易ID

    失败响应参考错误码部分。

示例

  • 请求示例

    POST /v1/ethereum/account HTTP/1.1
    Host: bbe.bj.baidubce.com
    x-bce-date: 2019-01-06T06:55:42Z
    x-bce-request-id: b9485394-c7dc-3cfa-d454-57c34773d08c
    Authorization: bce-auth-v1/5fded23b03594981872fbfadaad70ef6/2019-01-06T06:55:42Z/1800/host/84bc3dd2774cf6a6276a86e0cc7680e01710a1b7cb1a87de552af581131c818f
    
    {
        "balance": 1000,
        "networkUuid": "c3414b84-80cc-4c11-9933-78631724aab5"
    }
    
  • 响应示例

    200
    Content-Length: 153
    Content-Type: application/json; charset=utf-8
    Date: Fri, 04 Jan 2019 07:24:02 GMT
    
    {
        "data": {
            "address": "0x42328C24028Bb92366039b9Cc78dcC320461Cd69",
            "txId": "xxx"
        }
    }
    

查询账户私钥

接口描述
查询以太坊账户对应的私钥。

权限说明
请求发起人需要具有合法的AccessKeyID和SecretAccessKey才能发起请求。

注意事项
如果请求中没有用户验证信息(即匿名访问),返回403 Forbidden,错误信息:AccessDenied

请求(Request)

  • 请求语法

    GET /v1/ethereum/account/privateKey?address=xx&networkUuid=xx HTTP/1.1
    Host: bbe.bj.baidubce.com
    x-bce-date: <x-bce-date>
    x-bce-request-id: <x-bce-request-id>
    Authorization: <Authorization>
    
  • 请求参数

    名称 类型 描述 是否必须
    networkUuid String 网络ID 必须
    address String 以太坊账户地址 必须

响应(Response)

  • 响应头域
    除公共头域外,无其它特殊头域。

  • 响应参数

    名称 类型 描述
    privateKey String 以太坊账户私钥

    失败响应参考错误码部分。

示例

  • 请求示例

    GET /v1/ethereum/account/privateKey?address=0x42328C24028Bb92366039b9Cc78dcC320461Cd69&networkUuid=f5696c47-002d-40fe-89b7-8cc202181a7f HTTP/1.1
    Host: bbe.bj.baidubce.com
    x-bce-date: 2019-01-06T06:55:42Z
    x-bce-request-id: b9485394-c7dc-3cfa-d454-57c34773d08c
    Authorization: bce-auth-v1/5fded23b03594981872fbfadaad70ef6/2019-01-06T06:55:42Z/1800/host/84bc3dd2774cf6a6276a86e0cc7680e01710a1b7cb1a87de552af581131c818f
    
  • 响应示例

    200
    Content-Length: 153
    Content-Type: application/json; charset=utf-8
    Date: Fri, 04 Jan 2019 07:24:02 GMT
    
    {
        "data": {
            "privateKey": "7746566e612dace4de5e143347bb33620d299ba7fd9159cd625d808b79a2c4ed"
        }
    }
    

下载keystore

接口描述
下载一个账户的keystore

权限说明
请求发起人需要具有合法的AccessKeyID和SecretAccessKey才能发起请求。

注意事项
如果请求中没有用户验证信息(即匿名访问),返回403 Forbidden,错误信息:AccessDenied

请求(Request)

  • 请求语法

    GET /v1/ethereum/keystore?passphrase=123&address=xx&networkUuid=xx HTTP/1.1
    Host: bbe.bj.baidubce.com
    x-bce-date: <x-bce-date>
    x-bce-request-id: <x-bce-request-id>
    Authorization: <Authorization>
    
  • 请求头域
    除公共头域外,无其它特殊头域。

  • 请求参数

    名称 类型 描述 是否必须
    networkUuid String 网络ID 必须
    address String 以太坊账户地址 必须
    passphrase String 密码 必须

响应(Response)

  • 响应头域
    除公共头域外,无其它特殊头域。

  • 响应参数

    名称 类型 描述
    address String 以太坊账户地址
    keystore String keystore

    失败响应参考错误码部分。

示例

  • 请求示例

    GET /v1/ethereum/keystore?passphrase=123&address=0x42328C24028Bb92366039b9Cc78dcC320461Cd69&networkUuid=f5696c47-002d-40fe-89b7-8cc202181a7f  HTTP/1.1
    Host: bbe.bj.baidubce.com
    x-bce-date: 2019-01-06T06:55:42Z
    x-bce-request-id: b9485394-c7dc-3cfa-d454-57c34773d08c
    Authorization: bce-auth-v1/5fded23b03594981872fbfadaad70ef6/2019-01-06T06:55:42Z/1800/host/84bc3dd2774cf6a6276a86e0cc7680e01710a1b7cb1a87de552af581131c818f
    
  • 响应示例

    200
    Content-Length: 153
    Content-Type: application/json; charset=utf-8
    Date: Fri, 04 Jan 2019 07:24:02 GMT
    
    {
        "data": {
            "address": "0x42328C24028Bb92366039b9Cc78dcC320461Cd69",
            "keystore": "xxx"
        }
    }
    

删除账户

接口描述
删除一个以太坊账户。

权限说明
请求发起人需要具有合法的AccessKeyID和SecretAccessKey才能发起请求。

注意事项
如果请求中没有用户验证信息(即匿名访问),返回403 Forbidden,错误信息:AccessDenied

请求(Request)

  • 请求语法

    DELETE /v1/ethereum/account/:address?networkUuid=xx HTTP/1.1
    Host: bbe.bj.baidubce.com
    x-bce-date: <x-bce-date>
    x-bce-request-id: <x-bce-request-id>
    Authorization: <Authorization>
    
  • 请求头域
    除公共头域外,无其它特殊头域。

  • 请求参数

    名称 类型 描述 是否必须
    networkUuid String 网络ID 必须
    address String 以太坊账户地址 必须

响应(Response)

  • 响应头域
    除公共头域外,无其它特殊头域。

  • 响应参数
    失败响应参考错误码部分。

示例

  • 请求示例

    DELETE /v1/ethereum/account/0x42328C24028Bb92366039b9Cc78dcC320461Cd69?networkUuid=f5696c47-002d-40fe-89b7-8cc202181a7f HTTP/1.1
    Host: bbe.bj.baidubce.com
    x-bce-date: 2019-01-06T06:55:42Z
    x-bce-request-id: b9485394-c7dc-3cfa-d454-57c34773d08c
    Authorization: bce-auth-v1/5fded23b03594981872fbfadaad70ef6/2019-01-06T06:55:42Z/1800/host/84bc3dd2774cf6a6276a86e0cc7680e01710a1b7cb1a87de552af581131c818f
    
  • 响应示例

    200
    Content-Length: 0
    Content-Type: application/json; charset=utf-8
    Date: Fri, 04 Jan 2019 10:24:02 GMT