3. 飞签2.0接口需求（草稿）

飞签2.0接口需求（草稿）

  • 昌

    1. utxo

    • 快速转账用最小币天消耗：
      名称：quickPayUtxo；
      输入：1）address，2）amount；
      输出：1）按币天从小到大排序，取合计金额大于amount加矿工费的utxo，2）总币天，3）utxo数量
      错误：1）余额不足；2）所需utxo条目数超出最大值??（服务方设定），请先归整；
    • 信息上链用选择币天销毁
      名称：pickCoindaysUtxo；
      输入：1）address，2）mode（默认0为从小到大；1从大到小；2最小最大各一半）；3）number（请求的utxo数量）
      输出：按照mode给出小于等于number的utxo列表。
      错误：1）该地址没有utxo
    • 归整用币天小于特定值
      名称：mergeUtxo；
      输入：1）address，2）coindays；
      输出：1）币天小于coindays的所有utxo（根据性能自定义最大返回条目数）2）number（返回的utxo数量），3）coindaysSum（总币天销毁）
      错误：1）该地址没有币天小于coindays的utxo。

    2. 获取邀请人信息

    （即新地址的第一笔交易的第一个输入地址）
    基于协议https://bbs.cash/topic/562/fipa6v1_inviter-en-us
    名称：getInviter
    输入：address
    输出：1）address of inviter
    错误：1）该地址尚未使用。（即没有任何交易记录）2）该地址没有邀请人（即有交易没有邀请人。如治理基金地址或一些挖矿地址）。

    3. cid与地址

    基于协议https://bbs.cash/topic/537/feip3v4_cid-en-us

    • 获取cid
      名称：getCid
      输入：address
      输出：当前生效的cid
      错误：1）尚未注册cid；2）cid已注销。
    • 获取地址
      名称：getAddressOfCid
      输入：cid
      输出：address
      错误：1）cid不存在，2）该cid已注销。
    • 获取cid历史
      名称：getCidHistory
      输入：1）address
      输出：该地址所有cid链上历史记录数据，每条格式为：cid、操作、txid、交易时间
      错误：1）该地址没有注册过cid信息；

    4. 获取身份信息

    名称：getCidInfo
    输入：cid或address
    输出：1）cid，2）address，3）publicKey，4）balance，5）coindays，6）Reputation（信誉指数），7）inviter（邀请人），8）master（主控人）
    说明：1）邀请人，基于协议https://bbs.cash/topic/562/fipa6v1_inviter-en-us
    2）主控人，基于协议https://bbs.cash/topic/565/feip6v6_master-en-us

    5. 联系人

    基于协议https://bbs.cash/topic/575/feip12v3_contacts-en-us

    • 获取有效联系人
      名称：getContacts
      输入：1）address，2）startTime，起始时间，缺省从链上最早条目开始；3）endTime，截止时间，缺省为到最新位置
      输出：1）总条目数，2）本次返回数量，3）返回生效中的条目列表，结构：收到/发出、密文（用本人公钥加密的）、算法、时间、txid
      错误：1）没有符合条件的密信
    • 获取已删除联系人
      名称：getContactsDeleted
      输入：1）address，2）startTime，起始时间，缺省从链上最早条目开始；3）endTime，截止时间，缺省为到最新位置
      输出：1）总条目数，2）本次返回数量，3）返回已删除的条目列表，结构：密文、算法、创建时间、创建txid、删除txid、删除时间
      错误：1）没有符合条件的联系人

    6. 保险柜

    基于协议https://bbs.cash/topic/560/feip17v3_safe-en-us

    • 获取有效保险柜内容
      名称：getSafeContents
      输入：1）address，2）startTime，起始时间，缺省从链上最早条目开始；3）endTime，截止时间，缺省为到最新位置
      输出：1）总条目数，2）本次返回数量，3）返回条目列表，结构：密文、算法、创建时间、创建txid
      错误：1）没有符合条件的项目
    • 获取已删除保险柜内容
      名称：getSafeContentsDeleted
      输入：1）address，2）startTime，起始时间，缺省从链上最早条目开始；3）endTime，截止时间，缺省为到最新位置
      输出：1）总条目数，2）本次返回数量，3）返回已经删除的条目列表，结构：密文、算法、创建时间、创建txid、删除txid、删除时间
      错误：1）没有符合条件的项目

    7. 密信

    基于协议https://bbs.cash/topic/558/feip7v4_message-en-us

    • 获取密信内容
      名称：getMessages
      输入：1）address，2）startTime，起始时间，缺省从链上最早条目开始；3）endTime，截止时间，缺省为到最新位置
      输出：1）总条目数，2）本次返回数量，3）返回条目列表，结构：密文、算法、创建时间、创建txid
      错误：1）没有符合条件的密信
    • 获取已删除密信内容
      名称：getMessagesDeleted
      输入：1）address，2）startTime，起始时间，缺省从链上最早条目开始；3）endTime，截止时间，缺省为到最新位置
      输出：1）总条目数，2）本次返回数量，3）返回已经删除的密信列表，结构：密文、算法、创建时间、创建txid、删除txid、删除时间
      错误：1）没有符合条件的项目
    0
Log in to reply