Metalet Extension API Docs

Overview

Metalet is an browser extension wallet based on MetaidConnect protocol.

Once you install your Metalet extension wallet in your browser, Metalet will inject an object called metaidwallet in the window object of your page.

You can call Metalet apis using window.metaidwallet.{apiName}

You can connect to your Metalet account and perform various operations such as checking your balance, transferring funds, and signing transactions.

There are two types of api actions: authorize and query.

Calling an authorize action will pop up a window asking for permission to perform the requested action.
Calling a query action will return the requested data directly.

APIs

Account-related.

connect

Connect to the active account of Metalet.

Parameters

Nope.

Response

address - string

Example

const account =
  (await metaidwallet.connect()) >
  {
    address: '1xxxxxxxx',
  }

isConnected

Checks if the app is currently connected to the active account of Metalet.

Parameters

Nope.

Response

boolean

Example

;(await metaidwallet.isConnected()) > true

disconnect

Disconnect. It functions as Logout.

Parameters

Nope.

Response

status - 'ok'

Example

;(await metaidwallet.disconnect()) >
  {
    status: 'ok',
  }

getNetwork

Get the current network state.

Parameters

Response

network - 'mainnet' | 'testnet'

Example

;(await metaidwallet.getNetwork()) > { network: 'testnet' }

switchNetwork

Switch the network state of the current account.

Parameters

Nope.

Response

address - string
status - 'OK'
network - 'mainnet' | 'testnet'

Example

const account =
  (await metaidwallet.switchNetwork()) >
  {
    address: '1xxxxxxxx',
    status: 'OK',
    network: 'mainnet',
  }

getAddress

getAddress retrieves the address of the connecting account.

Parameters

Nope.

Response

address - string

Example

const address = (await metaidwallet.getAddress()) > '1xxxxxxxxxxxxxxxxxx'

getPublicKey

getPublicKey retrieves the public key of the connecting account.

Parameters

Nope.

Response

publicKey - string

Example

const publicKey = (await metaidwallet.getPublicKey()) > 'xxxxxxxthisisapubkeyxxxxx'

getXPublicKey

getXPublicKey retrieves the extended public key of the connecting account.

Parameters

Nope.

Response

xPublicKey - string

Example

const xPublicKey = (await metaidwallet.getXPublicKey()) > 'xxxxxxxthisisaextendedpubkeyxxxxx'

Native Token - aka. SPACE / BTC and so on…

getBalance

retrieves the current balance of the connecting account.

Parameters

Nope.

Response

address - string
confirmed - number, use satoshi as unit
unconfirmed - number, use satoshi as unit
total - number, use satoshi as unit

Example

const balanceInfo =
  (await metaidwallet.getBalance()) >
  {
    address: '1xxxxxxxx',
    confirmed: 92316234,
    unconfirmed: 0,
    total: 92316234,
  }

getUtxos - todo

getActivities - todo

transfer

The one-for-all transfer method.

Parameters

tasks - TransferOutput[]
- genesis? - string, required when type is token
- codehash? - string, required when type is token
- receivers - Reciever[]
- amount - string, do not pass numeric value here or Metalet will get upset.
- address - string
broadcast? - boolean, default to true

Response

res - TaskResponse[]
- id: number, the chronological index of the task, starts from 1
- txid: string
- txHex: string
- routeCheckTxid?: string, returned when it’s a token transfer transaction.
- routeCheckTxHex?: string, returned when it’s a token transfer transaction.
txids - string[]
broadcasted - boolean

merge

Let’s sign something.

signTransaction

Sign ONE transaction.

Parameters

transaction - TransactionInfo
- txHex: string
- address: string
- inputIndex: number
- scriptHex: string: the previous output script of this input
- satoshis: number: the previous output satoshis value of this input
- sigtype?: number: the sighash type

Response

signature - SigInfo
- publicKey: string
- r: string
- s: string
- sig: string
- sigtype: number

Example

const signTxRes =
  (await metaidwallet.signTransaction({
    transaction: {
      txHex: 'xxxxxxxxx',
      address: '1F7XgiBcErvnsh54YgwQbhG7Mxp8Mig2Vj',
      inputIndex: 0,
      scriptHex: '76a91436521092539d313000ea730def268b522f0c588688ac',
      satoshis: 30000,
      sigtype: 65,
    },
  })) >
  {
    signature: {
      publicKey: '026887958bcc4cb6f8c04ea49260f0d10e312c41baf485252953b14724db552aac',
      r: '7d4857743ddd3817039cc4813fc6ea585a6d535dbcd4c2d9864d8afab54acf59',
      s: '380aaecd30f7e86f08917fa21c96958b56d0a0cd91413e4a34cd7fddb4f75587',
      sig: '304402207d4857743ddd3817039cc4813fc6ea585a6d535dbcd4c2d9864d8afab54acf590220380aaecd30f7e86f08917fa21c96958b56d0a0cd91413e4a34cd7fddb4f7558741',
    },
  }

previewTransaction

Preview a transaction’s id before it is signed. Use this when you need to construct linear-dependent transactions.

Parameters

transaction - TransactionInfo
- txHex: string
- address: string
- inputIndex: number
- scriptHex: string: the previous output script of this input
- satoshis: number: the previous output satoshis value of this input
- sigtype?: number: the sighash type

Response

txid: string

Example

const previewTx =
  (await metaidwallet.previewTransaction({
    transaction: {
      txHex: 'xxxxxxxxx',
      address: '1F7XgiBcErvnsh54YgwQbhG7Mxp8Mig2Vj',
      inputIndex: 0,
      scriptHex: '76a91436521092539d313000ea730def268b522f0c588688ac',
      satoshis: 30000,
      sigtype: 65,
    },
  })) >
  {
    txid: 'abcthisisatxidjisdg...123',
  }

signTransactions

Sign multiple transactions. Returns signed raw transaction list.

Parameters

transactions - TransactionInfo[]
- txHex: string
- address?: string
- inputIndex: number
- scriptHex: string: the previous output script of this input
- satoshis: number: the previous output satoshis value of this input
- sigtype?: number: the sighash type
- path?: string: the sub derive path you are using. Default to 0/0.
- hasMetaId?: boolean: if this transaction is a MetaID transaction. If so, the op_return output will also be updated like we update the prevTxId in the input.
- dataDependsOn?: number: the index of the transaction in the list your OP_RETURN data is depend on. Required when hasMetaId is true.

Response

signedTransactions - Signed[]
- txid: string
- txHex: string

Example

const signTxRes =
  (await metaidwallet.signTransactions({
    transactions: [
      {
        txHex: 'xxxxxxxxx',
        address: '1F7XgiBcErvnsh54YgwQbhG7Mxp8Mig2Vj',
        inputIndex: 0,
        scriptHex: '76a91436521092539d313000ea730def268b522f0c588688ac',
        satoshis: 30000,
        sigtype: 65,
      },
      {
        // Assume that this transaction is dependent on the first one.
        // Therefore the prevTxId of this transaction's input might not be accurate.
        // This api will automatically recalculate the correct txid for you and replace it accordingly.
        txHex: 'xxxxxxxxx',
        address: '1F7XgiBcErvnsh54YgwQbhG7Mxp8Mig2Vj',
        inputIndex: 0,
        scriptHex: '76a91436521092539d313000ea730def268b522f0c588688ac',
        satoshis: 30000,
        sigtype: 65,
        path: '0/3',
        hasMetaId: true,
      },
    ],
  })) >
  // If the transactions are dependent, you have to broadcast them sequentially.
  {
    signedTransactions: [
      {
        txid: 'xxxxxxxxxx',
        txHex: 'xxxxxxxxxx',
      },
      {
        txid: 'xxxxxxxxxx',
        txHex: 'xxxxxxxxxx',
      },
    ],
  }

pay

signMessage

signMsg

Token

list

getBalance

Get the balance info of the token.

If no parameter is provided, the function will return all token information owned by the current account.

Parameters

genesis - string, the genesis of the token - optional
codehash - string, the codehash of the token - optional

Response

TokenInfo[]
- codehash - string, the codehash of the token
- genesis - string, the genesis of the token
- name - string
- symbol - string
- decimal - number
- utxoCount - number, the utxo count of this token the account owned
- confirmed - number
- confirmedString - string
- unconfirmed - number
- unconfirmedString - string

Example

const balanceInfo = await metaidwallet.token.getBalance()

> [
    {
        "codehash": "a2421f1e90c6048c36745edd44fad682e8644693",
        "genesis": "039032ade3d49a6d4ff41c33b3d63ea5c986f310",
        "name": "Test Token - 20:39",
        "symbol": "RR",
        "decimal": 18,
        "utxoCount": 2,
        ****"confirmed": 1000,
        "confirmedString": "1000",
        "unconfirmed": 0,
        "unconfirmedString": "0"
    },
    {
        "codehash": "57344f46cc0d0c8dfea7af3300b1b3a0f4216c04",
        "genesis": "76a8a2122b4f4213921cb0b4de0e7c704628f149",
        "name": "SPACE-MIT",
        "symbol": "SMIT",
        "decimal": 8,
        "utxoCount": 1,
        "confirmed": 19000009847,
        "confirmedString": "19000009847",
        "unconfirmed": 0,
        "unconfirmedString": "0"
    }
]

merge

getActivities

NFT

list

getActivities

transfer

Observable Events

Use metaidwallet.on API to attach your event handler to these events.

accountsChanged

// attach an event listener to `accountsChanged` event
metaidwallet.on('accountsChanged', (newAccount) => console.log(newAccount)) >
  {
    mvcAddress: '1kdiyourmvcaddress234',
    btcAddress: 'bc1pyourbtcaddress234',
  }

// remove the event listener
metaidwallet.removeListener('accountsChanged')

networkChanged

// attach an event listener to `networkChanged` event
metaidwallet.on('networkChanged', (network: string) => console.log(network)) > 'mainnet'

// remove the event listener
metaidwallet.removeListener('networkChanged')

Deprecating APIs

These APIs are going to be deprecated in the future.

requestAccount

Connect to the active account of Metalet.

Parameters

Nope.

Response

address - string

Example

const account =
  (await metaidwallet.requestAccount()) >
  {
    address: '1xxxxxxxx',
  }

getAccount

Connect to the active account of Metalet.

Parameters

Nope.

Response

address - string

Example

const account =
  (await metaidwallet.getAccount()) >
  {
    address: '1xxxxxxxx',
  }

exitAccount

Parameters

Nope.

Response

status - 'ok'

Example

;(await metaidwallet.exitAccount()) >
  {
    status: 'ok',
  }

getMvcBalance

Example

const balanceInfo =
  (await metaidwallet.getMvcBalance()) >
  {
    address: '1xxxxxxxx',
    confirmed: 92316234,
    unconfirmed: 0,
    total: 92316234,
  }

signTx

Sign transactions.

Parameters

list - TransactionInfo[]
- txHex: string
- address: string
- inputIndex: number
- scriptHex: string: the previous output script of this input
- satoshis: number: the previous output satoshis value of this input
- sigtype: number: the sighash type

Response

sigList - SigInfo[]
- publicKey: string
- r: string
- s: string
- sig: string

Example

const signTxRes =
  (await metaidwallet.signTx({
    list: [
      {
        txHex: 'xxxxxxxxx',
        address: '1F7XgiBcErvnsh54YgwQbhG7Mxp8Mig2Vj',
        inputIndex: 0,
        scriptHex: '76a91436521092539d313000ea730def268b522f0c588688ac',
        satoshis: 30000,
        sigtype: 65,
      },
    ],
  })) >
  {
    sigList: [
      {
        publicKey: '026887958bcc4cb6f8c04ea49260f0d10e312c41baf485252953b14724db552aac',
        r: '7d4857743ddd3817039cc4813fc6ea585a6d535dbcd4c2d9864d8afab54acf59',
        s: '380aaecd30f7e86f08917fa21c96958b56d0a0cd91413e4a34cd7fddb4f75587',
        sig: '304402207d4857743ddd3817039cc4813fc6ea585a6d535dbcd4c2d9864d8afab54acf590220380aaecd30f7e86f08917fa21c96958b56d0a0cd91413e4a34cd7fddb4f7558741',
      },
    ],
  }

metalet-labs / metalet-extension-next

readme

Metalet Extension API Docs

Overview

APIs

connect

Parameters

Response

Example

isConnected

Parameters

Response

Example

disconnect

Parameters

Response

Example

getNetwork

Parameters

Response

Example

switchNetwork

Parameters

Response

Example

getAddress

Parameters

Response

Example

getPublicKey

Parameters

Response

Example

getXPublicKey

Parameters

Response

Example

getBalance

Parameters

Response

Example

getUtxos - todo

getActivities - todo

transfer

Parameters

Response

merge

signTransaction

Parameters

Response

Example

previewTransaction

Parameters

Response

Example

signTransactions

Parameters

Response

Example

pay

signMessage

signMsg

Token

list

getBalance

Parameters

Response

Example

merge

getActivities

NFT

list

getActivities

transfer

Observable Events

accountsChanged

networkChanged

Deprecating APIs

requestAccount

Parameters