Sensible Contract

GitHub     Twitter     Discord    

📌 Sensible Contract is the only known solution that supports contract backward-tracing and collaboration without maintaining an off-chain state, which differs from all ‘oracle’ solutions around the BSV world. (the signature service is stateless)


The state-of-the-art of sophisticated FT/NFT/SWAP on Bitcoin SV
The middleware between real-world projects and sCrypt
The "missing piece" for pragmatic bitcoin developer

Read the Whitepaper of Sensible Contract (v0.2.0)

The Ecosystem #


  1. By using induction, Sensible Contract enables a single contract to detect the forged contracts from untrusted parties and do backward-tracing to its original transaction at a low cost.
  2. Sensible Contract provides the capability for multiple contracts from different inputs to identify and collaborate within a single transaction, which enables a much more assembled workflow and a solid contract framework.
  3. The capability is inherent in the current bitcoin script system. All functionalities can be achieved within the scope of the existing bitcoin script opcodes set.
  4. Sensible Contract is the middleware between your applications and the underlying bitcoin script dev tool like sCrypt, prepared for large-scale software development.
  5. Various contract templates it provides have been used and verified in multiple real-world projects. These invented wheels are formulated and production-ready.

More importantly, Sensible Contract has been matured and sophisticated since day one. It contains 3 fundamental protocols, 6 independent components, and 9 standalone projects integrated as case studies, even before being launched on Apr. 2, 2021. It allows different projects to communicate with each other within the same framework at a low cost.

  1. 感应合约 (通过运用归纳法) 以极低的成本实现了合约的 鉴伪与溯源,用极少量代码即可识别出伪造的合约输入。
  2. 感应合约允许 (同一笔交易内多个输入上的) 不同合约 相互识别并协作,为复杂度更高的大规模合约运用提供框架基础。
  3. 感应合约的能力为当前比特币脚本所固有, 在现有的脚本操作码集合内 即可实现全部功能。
  4. 感应合约服务于你的各类应用和底层脚本工具 sCrypt 之间,是 大型软件开发所需的中间件。
  5. 感应合约提供若干 已在真实项目中应用并验证 的合约模板及对应服务。这些造好的轮子可被直接用于生产环境。


  • 感应合约在被开发到具有极高的成熟度时,才被允许向外界发布。
  • 发布第一天,即包含 3 份基础协议,6 大功能组件,和 9 个不同项目集成作为案例。
  • “书同文,车同轨”,感应合约使得不同的项目,在同一框架下,以最低的成本与其他应用互通,具有极高的性价比。

Protocols #

📄 BCP-01: Non-Fungible Token

Sensible Contract built-in NFT protocol (Mirror of ERC-721)

📄 BCP-02: Fungible Token

Sensible Contract built-in FT protocol (Mirror of ERC-20)

📄 BCP-03: Unique Contract

Sensible Contract based Global State Protocol. It creates and maintains a global unique state on-chain, and can be used to implement advanced features like Swap.

Built-in Components, Tools & Services #

📌 All components, tools, and services are under MIT License.


Sensible Contract Fungible Token Implementation.

✏️ satotx

The reference implementation of Sensible Contract Signature Service.


A blockchain parsing service, providing parsed TX data for Sensible API.

BCP01 NFT Composer

The service helps to deploy NFT contract without caring about the signature.

BCP01 NFT Boilerplate

The source code here helps to issue and transfer NFT.

BCP02 FT Composer

The service helps to deploy FT contract without caring about the signature.

BCP02 FT Boilerplate

The source code here helps to issue and transfer FT.

Usecases #


Applications utilizing Sensible Contract as a contract solution:

TokenSwap     TokenSwap

TokenSwap is a combination of AMM and Dex built on top of Bitcoin SV blockchain using sCrypt and is utilizing Sensible Contract as its Token/NFT solution.

Volt     Volt

Volt is a wallet implemented with threshold technology and is integrating Sensible Contract as its Token/NFT solution.

MetaCoin     MetaCoin

MetaCoin is a series of tokens issued by the Open MetaNet Foundation Ltd, to incentivize users to use MetaID-related applications and create MetaID transactions. MetaCoin is based on Sensible Contract.

ShowApp     ShowApp

ShowApp is a MetaID-based social media App with a BSV wallet inside. It will support Sensible Contract as its token/NFT solution, and it will also support the Sensible token/NFT traded in Peer-to-Peer in the App.


Services supporting Sensible Contract as an app-layer protocol:

SensibleScan     SensibleScan

SensibleScan is a Sensible token/NFT and Sensible Contract explorer. With SensibleScan, users can view the details of every token/NFT and the smart contract based on Sensible.

Sensible API     Sensible API

Sensible API provides on-chain Sensible Contract related data querying for blockchain explorers.

Sensible Query     Sensible Query

Sensible Query provides on-chain Sensible Contract related browsing for blockchain explorers.

MetaSV     MetaSV

MetaSV is a blockchain data service provider and is working on supporting tokens and NFTs created by Sensible Contract.


Overshoot     Overshoot

“Overshoot” is the very first 3D shooting game on Bitcoin SV network, and uses Sensible Contract as its Token/NFT solution.

Satoplay     SatoPlay

SatoPlay is a BSV-based mobile game platform and has done the integration with Sensible Contract as its Token/NFT solution.

The brief history of Sensible Contract #

  • 2020-12-01 the initial talk

    Jiang Jie talked to Gu Lu and demonstrated the initial idea. We then decided to formulate it. We started to build the prototype and write the doc.

  • 2020-12-29 the v0.1 MVP

    The first viable prototype and the doc are available in less than one month.

  • 2021-01-08 the first peer-review

    We presented every bit to Edward Liu for a deep review. His feedbacks and ideas are quite positive, encouraging, and insightful. Many questions raised later by others, like interoperability between different dex(s) / tokens / contracts, were discussed. In that afternoon, we started to firmly believe this would be a game-changing solution for bitcoin application development. Things which were considered impossible for Layer-1, are now possible with Sensible Contract.

  • 2021-01-23 the first peer release & presentation

    Through an online meeting, we demonstrated our idea, prototype, and solution (known as v0.1.8) to a few senior Bitcoin SV developers, including Edward Liu, cc (Chen Cheng), Wang Yu (show apps) Xiaohui Liu (sCrypt), TshiMing Ho (MetaSV), Fuqiang Wang (Volt), Aaron (BA & nChain), Zheming Lin (Mempool & DotWallet), Li Long. Sensible Contract is explained in detail and the meeting is productive.

  • 2021-01-23 the proposal delivered to nChain

    Since an alternative implementation involves upgrading PreImage structure (by doing this Sensible Contract becomes 100% L1 gracefully), we propose the method to nChain for review about whether it’s applicable to adopt the change in future node upgrading plan.

  • 2021-01-31 the Zhuhai consensus

    To accelerate BSV token standardization process, Long Yun organized a one-day meeting in Zhuhai. Several dev-teams were invited to talk about various Token solutions currently on BSV. Inspirations were brought up and well discussed. Specifically, cc (Chen Cheng) helped us with utxo-based contract splitting. We made a firmly agreed consensus that Sensible Contract is widely applicable and technically reliable, and it could be the cornerstone of the de facto token protocol. We started to work together to integrate Sensible Contract into our projects and build applications on top of it.

  • 2021-02-21 the meetup in Beijing held by BA

    With the help from Bitcoin Association, we introduced Sensible Contract to a broader audience (including founders, tech-leaders, and experts from different companies in China) remotely. The audience was surprised about the possibilities that what can be implemented, and had an impression about bitcoin script and its utilization in real-world applications.

  • 2021-02-25 BTP protocol merged

    The developer of BTP worked pretty close with us for a few weeks, before merging BTP into Sensible Contract. We learned a lot about how to isolate and consolidate different code into a well-designed and organized utxo-set, which is far more efficient and less complicated.

  • 2021-03-25 SatoPlay Souvenir Cards: first Sensible NFT

    SatoPlay released the first application utilizing Sensible Contract as the underlying technology. The NFTs are issued on Bitcoin SV network as the very first bitcoin script based NFT. 1000+ cards are issued.

  • 2021-03-26 metacoin: the first Sensible FT in real-world

    MetaCoin is a series of tokens issued by the OpenMetaNetFoundation Ltd, to incentivize users to use MetaID-related applications. MetaCoin is based on Sensible Contract.

  • 2021-04-02 the public release

    Sensible Contract is released on 2021.04.02.

  • 2020-12-01 想法提出


  • 2020-12-29 实现 v0.1 MVP

    在不到一个月的时间里,我们完成了第一个 MVP 的实现和对应文档的编写。

  • 2021-01-08 首次同行评审

    我们把所有细节同刘老师 (老刘) 做了面对面的深入沟通,他给予了我们非常积极的反馈,巨大的鼓励和有洞察力的想法。后来被反复考虑的,dex 下不同 token 互通问题,不同体系合约的相互识别问题,在当时都是被老刘首次提出,也是当时探讨的主要关注点。在那天下午,我们开始确信这个方案蕴含的巨大价值,在很多方面,原来被认为是不可能在层一做到的事情,在感应合约下变得成为可能。

  • 2021-01-23 首次同行间发布和讲解

    通过一次在线会议,我们向若干 Bitcoin SV 高级工程师分享了感应合约的文档 (v0.1.8),展示了我们的想法,解决方案及原型。具体包括老刘,陈诚 (cc),王宇 (show apps 技术负责人),Xiaohui (sCrypt 创始人),何启明 (MetaSV 创始人),王福强 (Volt 创始人),周全 (nChain 技术专家),林哲明 (Mempool 和打点钱包创始人),李龙等。我们向大家解释了感应合约的原理和细节,并集中回答了大家的提问。一次非常有成效的沟通。

  • 2021-01-23 提交给 nChain

    在我们的方案中,通过升级 PreImage 结构,即可实现无需任何外部条件的比特币上的纯一层智能合约。我们把方案提交给 nChain,希望能了解到,该方案被包含在未来的节点升级中的可能性。如有可能,也希望能了解到 nChain 对完整方案的研究或评议的情况。

  • 2021-01-31 “珠海共识”

    出于加速 BSV 应用发展的目的,龙云 (飞龙) 组织和推动了针对 Token 的规范化工作。在他的组织与邀请下,若干关心感应合约的开发团队及个人在当天分别从全国各地赶赴珠海,进行了一天的研究和讨论。针对各类 Token 方案,大家从各自不同的理论及实践角度提出了自己的见解。其中,陈诚 (cc) 在合约拆分上,给了我们非常有力的帮助。在当天晚上,大家对感应合约的广阔适用性及技术可靠性形成了高度的评价。对于共同推动感应合约的发展,使之成为事实上的标准协议,我们达成了相当程度的共识,并开始更紧密地合作,在各自的项目中实现对感应合约的系统化支持,并开始在其上规划和构造全新的项目。

  • 2021-02-21 在北京会议上的介绍

    在比特币协会 (Bitcoin Association) 的帮助下,我们远程向更大的受众(包括国内不同行业的企业家和技术专家)介绍了感应合约及其可能被应用的领域。大家对 Bitcoin SV 作为公链的可能性感到非常惊讶,对比特币开发及工程化应用有了新的和具体的认识。他们同时向我们提出了更多的技术角度之外的问题,这些问题深深启发和鼓舞了我们,我们也尽我们所能向他们做了充分的讲解。

  • 2021-02-25 BTP 协议合并

    BTP 的开发者陈诚 (cc) 在这几周中与我们密切合作,并随后把 BTP 融合入感应合约的技术实现。我们学习到大量的技巧,关于如何把不同的逻辑按照设计好的 utxo 集来组织。这次技术融合,使得感应合约有了进化,变得更加高效和简单。

  • 2021-03-25 小聪游戏发布了基于感应合约的 NFT 2.0

    小聪 (SatoPlay) 发布了基于感应合约的首个产品 - 小聪 NFT 纪念卡组。这一批纪念卡组作为 NFT,以合约的形式运行于比特币网络之上。在发行的前三天,共铸造了 1000+ 的 NFT 纪念卡。

  • 2021-03-26 开放元网基金会发布基于感应合约FT的metacoin

    开放元网基金会发布了基于感应合约 FT 方案的 metacoin,用于激励用户使用 MetaID 相关应用,创造 MetaID 交易的通证。这是 Sensible Contract 工程化的重要一步。

  • 2021-04-02 公开发布

    感应合约于 2021.04.02 公开发布。

The vision

We devote to build a well-established cornerstone for bitcoin applications based on Sensible Contract.

Our mid-term objectives are:

  • Full-featured Bitcoin SV NFT
  • Full-featured Bitcoin SV Token
  • Full-featured Bitcoin SV Token Swap
  • BSV/Token/NFT any-pair on-chain exchange
  • Contract-Friendly data querying and browsing
  • Contract Model for more real-world cases…

Contact Us