Money Button Documentation

Money Button Documentation

  • Money Button
  • API
  • Examples
  • Paymail
  • bsv

›Paymail

Money Button

  • Money Button Overview
  • HTML
  • Javascript
  • React
  • Crypto Operations
  • Invisible Money Button
  • Paymail Signatures
  • Paymail Encryption

API

  • API Overview
  • Apps
  • Webhooks
  • Tokens
  • Currencies
  • Javascript Client
  • Authentication

    • Authentication Overview
    • OAuth
    • OAuth With JS Client

    API v1

    • Get User Identity
    • Get User Profile
    • Get User Balance
    • Get Payments
    • Get Payment By ID

    API v2

    • Get User Balances
    • Get Payments
    • Get Payment By ID
    • Get Assets
    • Create Asset
    • Modify Asset

Simple Fabriik Protocol for Tokens

  • Protocol Overview
  • Wallets Integration Guide
  • SFP Paymail Extension Build Action
  • SFP Paymail Extension Authorise Action

Examples

  • Examples Overview
  • OP_RETURN Scripts
  • Assets

Paymail

  • Paymail Overview
  • Paymail Video Series
  • Paymail Introduction
  • BRFC Specifications
  • Specification Documents
  • BRFC ID Assignment
  • Service Discovery
  • Host Discovery
  • Capability Discovery
  • Public Key Infrastructure
  • Payment Addressing
  • Payment Addressing (Basic Address Resolution)
  • Payment Addressing (Payer Validation)
  • Payment Addressing (Payee Approvals)
  • Payment Addressing (PayTo Protocol Prefix)
  • Verify Public Key Owner
  • P2P Transactions
  • P2P Payment Destination
  • P2P Payment Destination with Tokens Support
  • Asset Information
  • Recommendations

Bitcoin SV Library (bsv)

  • Bitcoin SV Library (bsv)
  • Big Numbers
  • Points (Elliptic Curves)
  • Hash Functions
  • Base 58
  • Private Keys
  • Public Keys
  • Addresses
  • ECDSA
  • Bitcoin Signed Messages
  • Signatures
  • HD Private Keys (BIP32)
  • HD Public Keys (BIP32)
  • Mnemonics (BIP39)
  • Script

Asset Information

title: Asset Information
author: Fabriik
version: 1
brfc: 1300361cb2d4

This extension provides information about an asset that has a paymail asigned, including asset name, avatar and protocol.

Motivation

Companies that provide tokens functionality, should provide a convenient way to get tokens information. Since, assets can be named using paymail (e.g. myasset@monneybutton.com) we have the ability to query the asset using paymail protocol. So, we will need to create an extension to represent tokens, that will allows to query basic information about the token: name, supply, description, graphical representation, etc.

Capability Discovery

The .well-known/bsvalias document is updated to include a declaration of the endpoint to receive asset information:

{
  "bsvalias": "1.0",
  "capabilities": {
    "1300361cb2d4": "https://example.bsvalias.tld/api/asset/{alias}@{domain.tld}"
  }
}

Client request

The capabilities.1300361cb2d4 path returns a URI template. {alias} and {domain.tld} placeholders should be replaced with a valid bsvalias handle of the asset. Then, the client can perform a http GET request to receive asset information.

Receiver Response

The response MUST include the following properties: name, protocol. The response SHOULD contain also extra information like description, avatar, supply, url. It also MAY include other properties which are protocol specific, like in the example below authorizerPubkey for SFP protocol.

200 OK

{
  "name": "Example Inc.",
  "protocol": "SFP@0.1",
  "protocolData": {
    "authorizerPubkey": "02629482acdae0266cc098c7d7241a2076627f21bde1a417ac348f1c3758bdaac2"
  },
  "supply": "10000000",
  "alias": "example@moneybutton.com",
  "description": "Example Inc. utility tokens.",
  "avatar": "https://www.example.com/stock.png",
  "url": "https://www.example.com/example-asset-information"
}

404 Not Found

The asset was not found.

← P2P Payment Destination with Tokens SupportRecommendations →
  • Motivation
  • Capability Discovery
  • Client request
  • Receiver Response
    • 200 OK
    • 404 Not Found
Money Button Documentation
Docs
Money ButtonAPIDesignbsv
Community
redditYoutubeTelegramTwitter
More
BlogInstagramGitHubStar
See an error in our documentation? Issue a pull request to fix it.
Copyright © 2022 Fermatted Drives Limited