Neber SDK

准备工作

部署流程

  • 引入SDK文件
  • 初始化接口对象

在需要调用JS接口的页面引入如下JS文件

您可以在 示例代码 中下载SDK文件

HTML代码 示例

  • 初始化并赋予 API 对象相关权限
  • 建议按照示例代码进行部署,以免影响实际体验
<script src="/neber.sdk.js" type="text/javascript"></script>
<script>
    var API;
    var isReady = function(Api){
        API = Api;
        API.bind('n1zUNqeBPvsyrw5zxp9mKcDdLTjuaEL7s39');//绑定合约
        API.bar('white');//可删除本行
    }
    function Events(){
        //这里开始执行相关接口
    }
</script>

提醒 请勿引入外部SDK文件,以防SDK文件被串改而带来不必要的损失

初始化

提醒 第三方应用调用无需以下步骤

  • API.bind 绑定合约 未绑定合约将无法使用任何接口
  • API.bar 状态栏颜色 目前仅支持白色、黑色两种颜色

接口函数

接口说明

开发者可根据DApp自身业务来调用相关的接口,下文仅作为常规业务环境进行基本区分

  • API.wallet 钱包信息 可获取钱包地址、钱包余额、NRC-20通证资产
  • API.pay 安全支付 发起NAS、NRC-20通证资产交易
  • API.push 静默授权 为智能合约提供后台上链服务(不支持NAS、NRC-20通证资产转出)
  • neber 唤醒Neber 第三方应用唯一可用接口

第三方应用/网页唤醒Neber

neber函数是唯一可外部唤醒并执行上链服务的接口函数,支持NAS、NRC-20通证资产交易和智能合约数据上链。

安全提示

提示:粘贴他人提供或互联网检索的非正规代码,可能造成以下几种安全风险

  • 可能存在冒用官方身份进行相关欺诈行为
  • 可能存在恶意授权、上链等未知风险
  • 可能被用于违法内容的宣传投放
  • 可能被第三方收集访客的身份、行为轨迹、个人隐私等风险行为

官方提醒 本SDK仅作为协助DApp完成与Neber互动上链而存在。如果您使用他人提供的SDK、执行代码,本平台将不承担任何关于您与用户间产生的纠纷。

示例代码

SDK文件(v1.0): neber.sdk.js

API.bind

  • 调用方式
    API.bind(contract);
  • contract string
    智能合约地址
  • 示例
    API.bind('n1zUNqeBPvsyrw5zxp9mKcDdLTjuaEL7s39');
  • Events
    function Events(){alert('绑定成功');}

API.bar

  • 调用方式
    API.bar(color);
  • color string
    white 或 black
  • 示例
    API.bar('white');

API.wallet

  • 调用方式
    API.wallet(contract,callback);
  • contract string
    空 或 智能合约地址
  • callback string
    回调函数名
  • 示例
    function callback(result){
        console.log(result);
    }
    API.wallet('','callback');

API.pay

  • 调用方式
    API.pay(contract, to, value, payload, option);
  • contract string
    空 或 智能合约地址
  • to string
    接收人的钱包地址
  • value number
    NAS数量 或 NRC-20通证资产数量
  • payload object
    {}
  • option object
    {'callback':'回调函数名','unique':唯一码}
  • 示例
    function callback(result){
        console.log(result);
    }
    API.pay('n1zUNqeBPvsyrw5zxp9mKcDdLTjuaEL7s39', 'n1dqCLcSJoEQ2GayZERpQHZBKbTbnrrgKWq', 0.001,{}, {'callback':'callback','unique':123456789});

API.push

  • 调用方式
    API.push(contract, payload, option);
  • contract string
    智能合约地址
  • payload object
    {"function":"合约函数","args":["上报数据"]}
  • option object
    {'callback':'回调函数名','unique':唯一码}
  • 示例
    function callback(result){
        console.log(result);
    }
    API.push('n1zUNqeBPvsyrw5zxp9mKcDdLTjuaEL7s39', {"function":"合约函数","args":["上报数据"]}, {'callback':'callback','unique':123456789});

neber

  • 调用方式
    neber(param);
  • param object
    {
        to:"n1dqCLcSJoEQ2GayZERpQHZBKbTbnrrgKWq",//接收地址
        contract:"",//合约地址
        value:"0.0001",//NAS数量 或 NRC-20通证资产数量
        params:"{\"function\":\"test\",\"args\":\"[1]\"}"
        //上报数据(接收地址为空 且 合约地址不为空时有效)
    }
  • 示例
    neber({to:"n1dqCLcSJoEQ2GayZERpQHZBKbTbnrrgKWq",contract:"",value:"0.0001",params:"{\"function\":\"test\",\"args\":\"[1,2,3]\"}"});

回调事务

上链成功后,Neber将根据开发者上报的回调函数名以触发相关回调事务。

  • 以下只是一个简单的回调示例
    <script src="/neber.sdk.js" type="text/javascript"></script>
    <script>
        var API;
        var isReady = function(Api){
            API = Api;
            API.bind('你的合约地址');//绑定合约
        }
        function callback(result){
            console.log(result);
        }
        function Events(){
            API.wallet('','callback');
        }
    </script>

调试环境

  • 正式发布前,请先在调试环境测试确认。