API:技术向 | 如何使用OFMF API 进行BTC/LTC跨链_RES

作者：

时间：

OFMF查询服务API是面向用户的公开的跨链查询接口，用户可以通过交易哈希查询到准确的跨链信息也可以用条件筛选的方法查询多组数据。API文档详见：OFMF查询服务API

本文通过Python3实现的简单示例展示如何使用OFMFAPI跨链并查询跨链的结果。在示例中，我们通过LTC跨链和查询的例子告诉你，如何使用OFMFAPI进行跨链。为此，我们需要做如下准备：

Python：演示代码使用Python编写，使用前请确保在你有Python3开发环境。本教程所有过程使用的版本为Python3.9.0

详细演示

为了详细的演示，我们通过Demo来讲解如何使用OFMFAPI进行跨链。每一个API都会对应一个函数。1、用户若想通过API跨链，首先需要创建一个跨链地址，目前暂时只支持BTC、LTC两个币种，以LTC为例。我们需要POST接口：/api/v1/create-cross-address针对接口，用户可以使用API请求工具或是自己编写程序进行访问。

动态 | 比特币 Taproot/Schnorr 技术升级已经作为改进提案 BIP 正式发布:比特币核心开发人员 Pieter Wuille 于去年 5 月提出的 Taproot / Schnorr 软分叉升级提案已正式作为比特币改进提案（BIPs）发布，即将进入正式实施阶段，相关提案序号分别为 BIP 340、341、342。Pieter Wuille 同时表示，这些提案文件是将 Taproot / Schnorr 集成到比特币的「最终建议」，但至于是否被生态系统接受以及如何接受将「取决于社区」。Taproot 由比特币核心开发人员 Greg Maxwell 于 2018 年 1 月首次发布，通过让所有交易对区块链数据的观察者保持相同，从而提供了新的隐私级别，在比特币扩展性、可替代性和脚本创新都有重要意义。Schnorr 签名是 Pieter Wuille 一直倡导引入比特币协议的技术拓展。链闻此前报道，Taproot/Schnorr 软分叉是 2020 年业内最令人期待的发展之一。随着社区已对协议向前发展方向已经达成共识，其他一些有前途的比特币提案，包括 Graftroot、SIGHASH_NOINPUT、「大共识清理」（The Great Consensus Cleanup）和 OP_CHECKTEMPLATEVERIFY，也可能在新的一年中取得进展。[2020/1/24]

需要注意的是：本文档中的所有API在使用的时候都需要accessToken：

声音 | 王春蕊：区块链已从技术构想走入现实在智慧城市建设中将大有作为:新京报智慧城市研究院研究员王春蕊今日发表题为“智慧城市和区块链能擦出怎样的火花？”评论文章。文章中提到，区块链在智慧城市建设中将大有作为。区块链实现信息共享，保障数据安全；“区块链+政务”，为数字社会增信；“区块链+民生”，能够提供更智能的公共服务。区块链作为核心技术，已经从技术构想走入现实，在智慧城市领域特别是信息共享方面彰显出了巨大应用潜力。（新京报）[2019/11/5]

Username：summaryPassword：ofmf

Demo请求函数中对于accessToken的添加已经封装完成，但如果用户使用Postman软件来调用接口，则需要在Authorization中选择BasicAuth并输入Username和Password，如图：

声音 | 人民在线总经理助理：互联网版权保护就是区块链技术很好的应用场景之一:10月24日，由人民在线、微众银行主办的“区块链版权保护场景应用与探索”研讨会在人民日报社新媒体大楼成功举办。人民在线总经理助理汪大伟做了研讨会的总结。他表示，区块链非常有价值，它可以让每一个节点都发挥优势，并将优势合而为一，创造出一个很好的生态。互联网版权保护就是区块链技术很好的应用场景之一。互联网媒体必须加强版权保护和版权交易以避免同质化竞争，做到差异化。同时，我们也需要开放内容生态，一方面要将优质的版权内容分发给流量平台，实现有效信息的充分传播；另一方面为流量平台提供便捷的版权授权服务，形成双赢局面，从而建设一个互相依存、互利互惠的生态，这是人民在线的心愿。融媒体建设未来要做到四个融合，即内部融合、党媒融合、跨业融合和社区融合。“人民版权”是促进党媒融合的重要抓手，也是人民在线体现社会责任的一个重要窗口。[2019/10/25]

PythonDemo的请求方法如下：

声音 | 重庆大学齐爱民：区块链等技术是中小企业的重要转折点:据凤凰网消息，重庆大学教授齐爱民表示，大数据时代，区块链成为底层技术架构，数据成为数字经济的关键生产要素，以数据为基础、以人工智能为主要驱动力的新型经济形态正在蓬勃发展。中国作为世界第二大经济体，互联网应用大国，有着发展区块链技术的先天优势，区块链+大数据是国内中小企业拥抱数字经济的重要转折点。[2018/12/10]

defcreate_cross_address(chain_name,vapor_address):url="https://ofmf.movapi.com/api/v1/create-cross-address"params={"chain_name":chain_name,"vapor_address":vapor_address}encoded_data=json.dumps(params).encode('utf-8')res=requests.post(url,encoded_data,auth=('summary','ofmf'))print(res.json())

动态 | TechFinancials推出基于区块链技术的钻石交易平台CEDEX测试版:据financemagnates消息，伦交所上市技术提供商TechFinancials（AIM：TECH）宣布推出基于区块链技术的钻石交易平台CEDEX测试版，该平台允许其客户将钻石作为数字化资产类别进行交易。据悉，TechFinancials参与了CEDEX区块链和智能合约开发。[2018/11/28]

Demo调用的示例：

create_cross_address("LTC","vp1qphgfqj9wyvcnqnfts3gdtp9ecms3shdkq7zcws")

目前本接口接入IP有白名单限制，如果非白名单IP内的请求，会报错“Permissiondenied”，如下：

目前IP白名单暂未对普通用户开放。白名单下正确访问，则返回如下结果：

{"code":200,"msg":"","data":{"cross_address":"MA4eeeSuThwCu4Jmf12DPuNUBqbjPvD1Hz"}}

用户可以对创建的跨链地址转入对应资产，收到转账后，合约会将相应侧链资产转入用户设置的侧链地址。以下是资产跨链的示例：

LTC交易哈希：2cbf2aa6f9b8a6f3643d3ddab41f61cdd9ca6d0a9d2c2a06398061fcc0ca8437

Vapor交易哈希：

884d5196e26d21b4c7667ba03f56430c429a3eb4cc765ee23a55e37b1376ed3e2、在上一步中，我们成功完成跨链，接下来我们通过交易哈希查询跨链信息，需要请求的接口：POST/api/v1/life-cycle

Demo示例：

deflist_cycle(hash):url="https://ofmf.movapi.com/api/v1/life-cycle"params={"tx_hash":hash}encoded_data=json.dumps(params).encode('utf-8')res=requests.post(url,encoded_data,auth=('summary','ofmf'))print(res.json())

通过如下方法使用

list_cycle("884d5196e26d21b4c7667ba03f56430c429a3eb4cc765ee23a55e37b1376ed3e")

3.用户如果需要对历史的跨链数据按条件查询，可以通过接口：POST/api/v1/life-cycles实现以下所有筛选项都使用，但是必选其中一项：

chain_name-币种，目前支持的币种：BTC、LTC、ETH、USDT、DAI、USDC

direction-跨链方向，in-跨入，out-跨出

before_timestamp-跨入交易所入区块时间戳之前的跨链信息

after_timestamp-跨入交易所入区块时间戳之后的跨链信息

Demo请求方法：

deflist_cycles(chain_name="",direction="",before_timestamp="",after_timestamp=""):url="https://ofmf.movapi.com/api/v1/life-cycles"params={}ifchain_name!="":params=chain_nameifdirection!="":params=directionifbefore_timestamp!="":params=before_timestampifafter_timestamp!="":params=after_timestampencoded_data=json.dumps(params).encode('utf-8')res=requests.post(url,encoded_data,auth=('summary','ofmf'))print(res.json())

请求示例：

list_cycles(chain_name="ETH",direction="in")