BigChainDB API 总结

最新推荐文章于 2021-07-31 14:58:33 发布
最新推荐文章于 2021-07-31 14:58:33 发布
阅读量766 收藏
点赞数 1
分类专栏： 区块链文档 文章标签： 区块链 api
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_41938180/article/details/107445000
版权

BigchainDB API文档

参考文档: http://docs.bigchaindb.com/en/latest/installation/api/http-client-server-api.html

1.概览

pathtype说明
/api/v1/transactions/{transaction_id}GET根据交易id查询某个交易
/api/v1/transactionsGET条件查询交易
/api/v1/transactionsPOST发送交易
---
/api/v1/outputsGET根据公钥查询output
---
/api/v1/assetsGET查询asset数据
---
/api/v1/metadataGET查询metadata数据
---
/api/v1/validatorsGET查询validators数据
---
/api/v1/blocks/{block_height}GET根据块高查询block信息
/api/v1/blocksGET根据交易id查询块高

2.tansaction API

2.1 根据交易id查询某个交易

  1. path：/api/v1/transactions/{transaction_id}
  2. 请求类型：GET
  3. 参数： {tansaction_id}：交易ID
  4. 例子
    请求：
	GET http://127.0.0.1:9984/api/v1/transactions/4957744b3ac54434b8270f2c854cc1040228c82ea4e72d66d2887a4d3e30b317

返回参数：

	{
	  "asset": {
	    "data": {
	      "msg": "Hello BigchainDB!"
	    }
	  },
	  "id": "4957744b3ac54434b8270f2c854cc1040228c82ea4e72d66d2887a4d3e30b317",
	  "inputs": [
	    {
	      "fulfillment": "pGSAIDE5i63cn4X8T8N1sZ2mGkJD5lNRnBM4PZgI_zvzbr-cgUCy4BR6gKaYT-tdyAGPPpknIqI4JYQQ-p2nCg3_9BfOI-15vzldhyz-j_LZVpqAlRmbTzKS-Q5gs7ZIFaZCA_UD",
	      "fulfills": null,
	      "owners_before": [
	        "4K9sWUMFwTgaDGPfdynrbxWqWS6sWmKbZoTjxLtVUibD"
	      ]
	    }
	  ],
	  "metadata": {
	    "sequence": 0
	  },
	  "operation": "CREATE",
	  "outputs": [
	    {
	      "amount": "1",
	      "condition": {
	        "details": {
	          "public_key": "4K9sWUMFwTgaDGPfdynrbxWqWS6sWmKbZoTjxLtVUibD",
	          "type": "ed25519-sha-256"
	        },
	        "uri": "ni:///sha-256;PNYwdxaRaNw60N6LDFzOWO97b8tJeragczakL8PrAPc?fpt=ed25519-sha-256&cost=131072"
	      },
	      "public_keys": [
	        "4K9sWUMFwTgaDGPfdynrbxWqWS6sWmKbZoTjxLtVUibD"
	      ]
	    }
	  ],
	  "version": "2.0"
	}

2.2 根据条件查询

  1. path:/api/v1/transactions?asset_id={asset_id}&operation={CREATE|TRANSFER}&last_tx={true|false}
  2. 请求类型：GET
  3. 参数
参数类型是否必须说明
asset_idstring是交易id
operationstring否可填 CREATE 或 TRANSFER。不填增则查询所有的包含该asset_id的全部的交易。
last_txstring是可填true或false。true代表查询最后一次关于asset_id的交易信息，false返回全部(新参数，需要验证)
  1. 例子：

请求

GET http://127.0.0.1:9984/api/v1/transactions?operation=TRANSFER&asset_id=4957744b3ac54434b8270f2c854cc1040228c82ea4e72d66d2887a4d3e30b317

返回参数

[{
  "asset": {
    "id": "4957744b3ac54434b8270f2c854cc1040228c82ea4e72d66d2887a4d3e30b317"
  },
  "id": "79ef6803210c941903d63d08b40fa17f0a5a04f11ac0ff04451553a187d97a30",
  "inputs": [
    {
      "fulfillment": "pGSAIDE5i63cn4X8T8N1sZ2mGkJD5lNRnBM4PZgI_zvzbr-cgUAYRI8kzKaZcrW-_avQrAIk5q-7o_7U6biBvoHk1ioBLqHSBcE_PAdNEaeWesAAW_HeCqNUWKaJ5Lzo5Nfz7QgN",
      "fulfills": {
        "output_index": 0,
        "transaction_id": "4957744b3ac54434b8270f2c854cc1040228c82ea4e72d66d2887a4d3e30b317"
      },
      "owners_before": [
        "4K9sWUMFwTgaDGPfdynrbxWqWS6sWmKbZoTjxLtVUibD"
      ]
    }
  ],
  "metadata": {
    "sequence": 1
  },
  "operation": "TRANSFER",
  "outputs": [
    {
      "amount": "1",
      "condition": {
        "details": {
          "public_key": "3yfQPHeWAa1MxTX9Zf9176QqcpcnWcanVZZbaHb8B3h9",
          "type": "ed25519-sha-256"
        },
        "uri": "ni:///sha-256;lu6ov4AKkee6KWGnyjOVLBeyuP0bz4-O6_dPi15eYUc?fpt=ed25519-sha-256&cost=131072"
      },
      "public_keys": [
        "3yfQPHeWAa1MxTX9Zf9176QqcpcnWcanVZZbaHb8B3h9"
      ]
    }
  ],
  "version": "2.0"
},
{
  "asset": {
    "id": "4957744b3ac54434b8270f2c854cc1040228c82ea4e72d66d2887a4d3e30b317"
  },
  "id": "1fec726a3b426498147f1a1f19a92c187d551a7f66db4b88d666d7dcc10e86a4",
  "inputs": [
    {
      "fulfillment": "pGSAICw7Ul-c2lG6NFbHp3FbKRC7fivQcNGO7GS4wV3A-1QggUARCMty2JBK_OyPJntWEFxDG4-VbKMy853NtqwnPib5QUJIuwPQa1Y4aN2iIBuoqGE85Pmjcc1ScG9FCPSQHacK",
      "fulfills": {
        "output_index": 0,
        "transaction_id": "79ef6803210c941903d63d08b40fa17f0a5a04f11ac0ff04451553a187d97a30"
      },
      "owners_before": [
        "3yfQPHeWAa1MxTX9Zf9176QqcpcnWcanVZZbaHb8B3h9"
      ]
    }
  ],
  "metadata": {
    "sequence": 2
  },
  "operation": "TRANSFER",
  "outputs": [
    {
      "amount": "1",
      "condition": {
        "details": {
          "public_key": "3Af3fhhjU6d9WecEM9Uw5hfom9kNEwE7YuDWdqAUssqm",
          "type": "ed25519-sha-256"
        },
        "uri": "ni:///sha-256;Ll1r0LzgHUvWB87yIrNFYo731MMUEypqvrbPATTbuD4?fpt=ed25519-sha-256&cost=131072"
      },
      "public_keys": [
        "3Af3fhhjU6d9WecEM9Uw5hfom9kNEwE7YuDWdqAUssqm"
      ]
    }
  ],
  "version": "2.0"
}]

2.3 发送交易

  1. path：/api/v1/transactions?mode={mode}
  2. 请求类型：POST
  3. 参数
参数类型是否必须说明
modestring否可选 async,sync,commit。默认为async。async:请求立即响应，在Tendermint请求BigchainDB服务器检查事务的有效性之前立即返回。sync:在Tendermint从BigchainDB Server获得有关交易有效性的响应后，HTTP响应将返回。commit:表示交易在提交到块中在返回响应。
  1. 例子：
    请求：
POST http://127.0.0.1:9984/api/v1/transactions?mode=async

请求参数

{
  "asset": {
    "data": {
      "msg": "Hello BigchainDB!"
    }
  },
  "id": "4957744b3ac54434b8270f2c854cc1040228c82ea4e72d66d2887a4d3e30b317",
  "inputs": [
    {
      "fulfillment": "pGSAIDE5i63cn4X8T8N1sZ2mGkJD5lNRnBM4PZgI_zvzbr-cgUCy4BR6gKaYT-tdyAGPPpknIqI4JYQQ-p2nCg3_9BfOI-15vzldhyz-j_LZVpqAlRmbTzKS-Q5gs7ZIFaZCA_UD",
      "fulfills": null,
      "owners_before": [
        "4K9sWUMFwTgaDGPfdynrbxWqWS6sWmKbZoTjxLtVUibD"
      ]
    }
  ],
  "metadata": {
    "sequence": 0
  },
  "operation": "CREATE",
  "outputs": [
    {
      "amount": "1",
      "condition": {
        "details": {
          "public_key": "4K9sWUMFwTgaDGPfdynrbxWqWS6sWmKbZoTjxLtVUibD",
          "type": "ed25519-sha-256"
        },
        "uri": "ni:///sha-256;PNYwdxaRaNw60N6LDFzOWO97b8tJeragczakL8PrAPc?fpt=ed25519-sha-256&cost=131072"
      },
      "public_keys": [
        "4K9sWUMFwTgaDGPfdynrbxWqWS6sWmKbZoTjxLtVUibD"
      ]
    }
  ],
  "version": "2.0"
}

返回参数：

{
  "asset": {
    "data": {
      "msg": "Hello BigchainDB!"
    }
  },
  "id": "4957744b3ac54434b8270f2c854cc1040228c82ea4e72d66d2887a4d3e30b317",
  "inputs": [
    {
      "fulfillment": "pGSAIDE5i63cn4X8T8N1sZ2mGkJD5lNRnBM4PZgI_zvzbr-cgUCy4BR6gKaYT-tdyAGPPpknIqI4JYQQ-p2nCg3_9BfOI-15vzldhyz-j_LZVpqAlRmbTzKS-Q5gs7ZIFaZCA_UD",
      "fulfills": null,
      "owners_before": [
        "4K9sWUMFwTgaDGPfdynrbxWqWS6sWmKbZoTjxLtVUibD"
      ]
    }
  ],
  "metadata": {
    "sequence": 0
  },
  "operation": "CREATE",
  "outputs": [
    {
      "amount": "1",
      "condition": {
        "details": {
          "public_key": "4K9sWUMFwTgaDGPfdynrbxWqWS6sWmKbZoTjxLtVUibD",
          "type": "ed25519-sha-256"
        },
        "uri": "ni:///sha-256;PNYwdxaRaNw60N6LDFzOWO97b8tJeragczakL8PrAPc?fpt=ed25519-sha-256&cost=131072"
      },
      "public_keys": [
        "4K9sWUMFwTgaDGPfdynrbxWqWS6sWmKbZoTjxLtVUibD"
      ]
    }
  ],
  "version": "2.0"
}

3. output API

3.1 查询output数据

  1. path：/api/v1/outputs
  2. 请求类型：GET
  3. 请求参数：
参数类型是否必须说明
public_keystring是公钥
spentstring否可选 true 或false。如果不填改参数，返回该公钥下的所有output（未交易和交易）。true返回已经交易的output。false返回没有交易的output。
  1. 例子：
    请求：
GET http://127.0.0.1:9984/api/v1/outputs?public_key=1AAAbbb...ccc&spent=true

返回参数

[
  {
    "output_index": 0,
    "transaction_id": "2d431073e1477f3073a4693ac7ff9be5634751de1b8abaa1f4e19548ef0b4b0e"
  }
]

4. asset API

4.1 查询asset数据

  1. path：/api/v1/assets
  2. 请求类型：GET
  3. 请求参数：
参数类型是否必须说明
searchstring是查询参数
limitint否查询结果返回的个数。不填此参数，则返回包含search的所有asset信息
  1. 例子
    请求参数：
GET http://127.0.0.1:9984/api/v1/assets?search=bigchaindb&limit=2

返回参数：

[
    {
        "data": {"msg": "Hello BigchainDB 1!"},
        "id": "51ce82a14ca274d43e4992bbce41f6fdeb755f846e48e710a3bbb3b0cf8e4204"
    },
    {
        "data": {"msg": "Hello BigchainDB 2!"},
        "id": "b4e9005fa494d20e503d916fa87b74fe61c079afccd6e084260674159795ee31"
    },
]

5. metadata API

5.1 查询metadatat数据

  1. path：/api/v1/assets
  2. 请求类型：GET
  3. 请求参数：
参数类型是否必须说明
searchstring是查询参数
limitint否查询结果返回的个数。不填此参数，则返回包含search的所有metadata信息。（官网说默认0返回全部）待验证。
  1. 例子
    请求参数：
GET http://127.0.0.1:9984/api/v1/metadata?search=bigchaindb&limit=2

返回参数：

[
    {
        "metadata": {"msg": "Hello BigchainDB 1!"},
        "id": "51ce82a14ca274d43e4992bbce41f6fdeb755f846e48e710a3bbb3b0cf8e4204"
    },
    {
        "metadata": {"msg": "Hello BigchainDB 2!"},
        "id": "b4e9005fa494d20e503d916fa87b74fe61c079afccd6e084260674159795ee31"
    },
]

6. Validators API

6.1 查询Validators数据

  1. path：/api/v1/validators
  2. 请求类型：GET
  3. 例子

请求参数：

GET http://127.0.0.1:9984/api/v1/validators

返回参数：

[
    {
        "pub_key": {
             "data":"4E2685D9016126864733225BE00F005515200727FBAB1312FC78C8B76831255A",
               "type":"ed25519"
        },
        "power": 10
    },
    {
         "pub_key": {
               "data":"608D839D7100466D6BA6BE79C320F8B81DE93CFAA58CF9768CF921C6371F2553",
               "type":"ed25519"
         },
         "power": 5
    }
]

7. Blocks API

7.1 通过块高查询区块的数据

  1. path：/api/v1/blocks/{block_height}
  2. 请求类型：GET
  3. 请求参数：
参数类型是否必须说明
block_heightint是块高
  1. 例子
    请求参数：
GET http://127.0.0.1:9984/api/v1/blocks/1

返回参数：

{
  "height": 1,
  "transactions": [
    {
      "asset": {
        "data": {
          "msg": "Hello BigchainDB!"
        }
      },
      "id": "4957744b3ac54434b8270f2c854cc1040228c82ea4e72d66d2887a4d3e30b317",
      "inputs": [
        {
          "fulfillment": "pGSAIDE5i63cn4X8T8N1sZ2mGkJD5lNRnBM4PZgI_zvzbr-cgUCy4BR6gKaYT-tdyAGPPpknIqI4JYQQ-p2nCg3_9BfOI-15vzldhyz-j_LZVpqAlRmbTzKS-Q5gs7ZIFaZCA_UD",
          "fulfills": null,
          "owners_before": [
            "4K9sWUMFwTgaDGPfdynrbxWqWS6sWmKbZoTjxLtVUibD"
          ]
        }
      ],
      "metadata": {
        "sequence": 0
      },
      "operation": "CREATE",
      "outputs": [
        {
          "amount": "1",
          "condition": {
            "details": {
              "public_key": "4K9sWUMFwTgaDGPfdynrbxWqWS6sWmKbZoTjxLtVUibD",
              "type": "ed25519-sha-256"
            },
            "uri": "ni:///sha-256;PNYwdxaRaNw60N6LDFzOWO97b8tJeragczakL8PrAPc?fpt=ed25519-sha-256&cost=131072"
          },
          "public_keys": [
            "4K9sWUMFwTgaDGPfdynrbxWqWS6sWmKbZoTjxLtVUibD"
          ]
        }
      ],
      "version": "2.0"
    }
  ]
}

7.2 通过块高查询区块的数据

  1. path：/api/v1/blocks
  2. 请求类型：GET
  3. 请求参数：
参数类型是否必须说明
transaction_idstring是交易id
  1. 例子
    请求参数：
GET http://127.0.0.1:9984/api/v1/blocks?transaction_id=4957744b3ac54434b8270f2c854cc1040228c82ea4e72d66d2887a4d3e30b317

返回参数：

[
  1
]
可耳（keer）
关注
  • 1
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
专栏目录
BigchainDB白皮书，中文翻译
fengqing79的专栏
04-13 1万+
BigChainDB：可扩展区块链数据库 这篇白皮书介绍BigChainDB。BigChainDB填补了去中心生态系统中的一个空白：是一个可用的去中心数据库。它具有每秒百万次写操作，存储PB级别的数据和亚秒级响应时间的性能。BigChainDB的设计起始于分布式数据库，通过创新加入了很多区块链的特性，像去中心控制、不可改变性、数字资产的创建和移动。BigChainDB继承了现代分布式数据库的特性
bigchaindb：认识BigchainDB。 区块链数据库
02-03
BigchainDB服务器 BigchainDB是区块链数据库。 该存储库用于BigchainDB Server 。 基础知识 从master分支运行和测试BigchainDB服务器 运行和测试最新版本的BigchainDB Server非常容易。 确保您已安装最新版本的 。 准备就绪后，启动终端并运行： git clone https://github.com/bigchaindb/bigchaindb.git cd bigchaindb make run 现在应该可以在http://localhost:9984/上访问BigchainDB。 您还可以执行其他命令： make star
巨链数据库（BigchainDB）：一个可扩展的区块链型数据库（草稿）
03-13
BigchainDB,一款基于RethinkDB的区块链专用数据库。
BigChainDB（巨链数据库）
王磊的博客
10-23 5046
区块链是用来存储数据的，区块链 = 数据库。   BigChainDB 是一个去中心化的数据库，具有每秒 百万次 写操作，可以存储大量数据（PB级别），1 PB = 1000 TB，具有亚秒级响应时间的性能。设计是起始于分布式数据库，但添加了很多区块链的特性，比如去中心控制、不可改变性、数字资产的创建和移动。   吞吐量和容量与节点数 线性相关的，通过NoSQL 查询语言，进行高效地查询和...
BigchainDB关键概念
nbhwg的博客
12-18 2219
BigchainDB关键概念
BigchainDB，区块链与数据存储
跨链技术践行者
07-31 1110
自从我写这篇文章以来，BigchainDB和区块链领域已经发生了很大的变化，所以现在似乎是重新审视和更新区块链对传统计算领域更基本部分之一的影响的时候了：数据存储。 BigchainDB最初是作为替代Ascribe数字艺术品跟踪项目中比特币区块链的技术而构建的，它扩展为废弃IPDB的一个组件，现在作为Ocean protocol的存储层。 这种使用的变化导致了BigchainDB的基础和实现的变化，RethinkDB的关闭也迫使团队将存储引擎切换到坚固的MongoDB。数据库顶部的区块链层提供了有助
BigchainDB 2.0 交易模型
weixin_44057343的博客
03-27 406
BigchainDB 2.0 交易模型交易组件idversioninput**input的基本结构**fulfillsowners_beforefulfillmentoutputconditionoperationassetmetadata 交易组件 { “id”: id, “version”: version, “inputs”: inputs, “outputs”: outputs, “op...
如何在基于Bytom开发过程中使用Bigchaindb
weixin_34185364的博客
01-25 164
上期我们讲了在基于比原开发过程中链外存储可以用分布式存储IPFS,这期我们还给大家介绍另外一种链外存储的解决方案。bigchaindb:https://www.bigchaindb.com,下面我们讲一下集成过程。 step1:搭建Bytom节点 比原相关资料：https://github.com/Bytom-Comm... 搭建byto...
BigChainDB
thefist的专栏
05-12 175
bigchaindb_什么是BigchainDB？
cumo3681的博客
07-07 406
bigchaindb 东卡罗莱纳大学计算机科学专业的Sophia Armstrong在10月23日于北卡罗来纳州罗利市举办的All Things Open 2018的闪电演讲“网络安全学习环境的区块链数据库”中概述了BigchainDB 。 索菲亚（Sophia）的项目由国家科学基金会（National Science Foundation）资助，为学生提供基于游戏的动手实践，以了解网络安全...
BigchainDB: A Scalable Blockchain Database
03-21
使用区块链技术改造传统数据库，使其具有不可篡改性，同时较为简单的实现分布式数据库或数据库多活
dashboard:一个将BigchainDB交易显示为动态时间表视图的React应用
05-06
BigchainDB仪表板/资源管理器 这是一个react / redux单页应用程序，使用从BigchainDB Websocket广播的有效交易，将BigchainDB交易显示为动态时间轴视图。 该应用程序可用于可视化任何BigchainDB部署上的事务和块。 ...
js-bigchaindb-driver:适用于Node.js和浏览器的官方BigchainDB JavaScript驱动程序
05-06
BigchainDB JavaScript驱动程序的版本4.0使该驱动程序与BigchainDB 2.0兼容。 有一些新功能可以发送事务以及其他更改。 检查 BigchainDB JavaScript驱动程序的3.2版引入了一种创建转移交易的新方法。 检查 目录 安装...
bigchaindb-android
05-08
bigchaindb-android 这是一个与服务器2.0进行交互的基本android应用。 该驱动程序正在开发中，但是现在您可以使用一个输入/输出创建和传输事务。 驱动程序不使用创建的Java类，而是使用一个名为CustomTransaction...
bigchaindb-express-boilerplate:BigchainDB Express样板
05-02
BigchainDB Express样板 目录布局 . ├── /dist/ # The compiled output (via Babel) ├── /src/ # Node.js application source files │ ├── /abstracts # Abstract classes │ │ └── /AbstractRouter....
bigchaindb源码分析（六）——写事务（下）
lwyeluo的专栏
07-16 969
我们之前在源码分析（二）——pipeline中说到，在命令bigchaindb start执行后，bigchaindb将会利用pipeline来运行很多进程，如block\vote等等源码分析（五）中分析了在客户端利用API往bigchaindb写事务时，实际上只是将事务写入到了表backlog中，那么如何处理backlog中的事务则很明显要依赖于在start时创建的进程了首先来回顾创建block对
BigchainDB项目及相关资料
Harry Wong的博客
10-12 350
摘要BigchainDB是在一个企业级的分布式数据库上构建的，采用Tendermint共识，具有高吞吐量，大容量特性，全NoSQL查询语言支持。针对BigchainDB研究，整理相关资料。 BigchainDB 一． BigchainDB架构与关键组件 1．网络架构 如下图所示，在BigchainDB中，每个节点拥有自己独立的mongodb数据库，节点之间...
docker启动bigchaindb
qq_26653359的博客
11-27 229
docker run -d –name bigchaindb -p 9984:9984 -p 9985:9985 -p 27017:27017 -p 26657:26657 -v $HOME/bigchaindb_docker/mongodb/data/db:/data/db -v $HOME/bigchaindb_docker/mongodb/data/configdb:/data/configdb -v $HOME/bigchaindb_docker/tendermint:/tender
bigchaindb源码分析（一）——命令行参数与配置文件解析
lwyeluo的专栏
07-02 2059
bigchaindb版本：BigchainDB (1.0.0rc1) bigchaindb-driver (0.3.1)命令行参数解析使用whereis定位bigchaindb可执行文件为/usr/local/bin/bigchaindb，该文件调用了bigchaindb.commands.bigchaindb.main()函数。re.sub(r'(-script\.pyw?|\.exe)?$',
BigchainDB用来存储区块头，用mysql存储区块体
最新发布
04-01
这说法不完全正确。BigchainDB是一个基于区块链技术的分布式数据库，它可以存储完整的区块链数据，包括区块头和区块体。BigchainDB使用了一种名为“分片”的技术来实现高效的数据存储和查询。在分片技术中，区块链数据被分割成多个小块，每个小块可以存储在不同的节点上，以实现数据的分布式存储和处理。因此，BigchainDB不需要使用MySQL或其他关系型数据库来存储区块体。相反，它使用自己的专有数据存储和查询系统来管理和访问区块链数据。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值