JSPM

@dark-fusion-protocol/scl-wallet

1.0.5
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 12
  • Score
    100M100P100Q41200F
  • License ISC

SCL NPM Package

Package Exports

  • @dark-fusion-protocol/scl-wallet
  • @dark-fusion-protocol/scl-wallet/scl_wallet.js
  • @dark-fusion-protocol/scl-wallet/scl_wallet_bg.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@dark-fusion-protocol/scl-wallet) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

scl-wallet

SCL Wallet NPM Package

NPM Library

Initialization

[!NOTE] An empty SCLWallet object must be created to use the library.

import SclWallet 

var wallet = new SclWallet();

Create Wallet

Parameters

Parameter Type Description Example
wallet_name string The name of the wallet. "WalletName"
password string The password of the wallet. "password"

Code

const result = await wallet.create_wallet(wallet_name, password);

Results

Output Type Description
{"Result":"water danger cupboard garlic offer display lake boring piece clay identify giggle"} result The wallet is created successfully.
{"Result":"Wallet already exists!"} result The wallet has already been created with that name.
{"Error":"Database error."} error There is an issue with the indexedDB.

Init

Parameters

Parameter Type Description Example
wallet_name string The name of the wallet. "WalletName"
password string The password of the wallet. "password"
network string The network you are using (mainnet or testnet). "mainnet"
esplora_url string The address of the esplora you are using. "https://blockstream.info/"

Code

const result = await wallet.init(wallet_name, password, network, esplora_url);

Results

Output Type Description
{"Result":"Wallet successfully loaded."} result The wallet is loaded successfully.
{"Error":"Database error."} error There is an issue with the indexedDB.
{"Error":"Decryption failed. Wrong password."} error The password is incorrect.
{"Error":"You need to call create wallet first!"} error A wallet has not been created yet.

Generate Wallet

Parameters

Parameter Type Description Example
wallet_name string The name of the wallet. "WalletName"
password string The password of the wallet. "password"
seed_phrase string The seed phrase generated on wallet creation. "water danger cupboard garlic offer display lake boring piece clay identify giggle"

Code

const result = await wallet.generate_wallet(wallet_name, password, seed_phrase);

Results

Output Type Description
{"Result":"water danger cupboard garlic offer display lake boring piece clay identify giggle"} result The wallet is created successfully.
{"Result":"Wallet already exists!"} result The wallet has already been created with that name.
{"Error":"Database error."} error There is an issue with the indexedDB.
{"Error":"Invalid mnemonic."} error The mnemonic is invalid.

Has Wallet

Parameters

Parameter Type Description Example
wallet_name string The name of the wallet. "WalletName"

Code

const result = await wallet.has_wallet(wallet_name);

Results

Output Type Description
{"Result":"Wallet exists."} result The wallet exists.
{"Result":"No Wallet found."} result The wallet does not exist.
{"Error":"Database error."} error There is an issue with the indexedDB.

Generate Seed Phrase

Code

const result = wallet.gen_seed_phrase();

Results

Output Type Description
"water danger cupboard garlic offer display lake boring piece clay identify giggle" result Generate the mnemonic.

Get Mnemonic

Parameters

Parameter Type Description Example
password string The password of the wallet. "password"

Code

const result = await wallet.get_mnemonic(password);

Results

Output Type Description
{"Result":"water danger cupboard garlic offer display lake boring piece clay identify giggle"} result The mnemonic is returned.
{"Error":"Database error."} error There is an issue with the indexedDB.
{"Error":"Wallet not initialized."} error The wallet is not initialized.
{"Error":"Deserialization failed."} error There is an issue deserializing the mnemonic.
{"Error":"Decryption failed. Wrong password."} error The password is incorrect.

Sync

Code

const result = await wallet.sync();

Results

Output Type Description
{"Result":"Sync successful."} result The wallet has synced successfully.
{"Error":"Database error."} error There is an issue with the indexedDB.
{"Error":"Wallet not initialized."} error There is an issue with finding the esplora url/finding the address.
{"Error":"Failed to get result."} error There is an issue checking the UTXOs.
"Unable to deserialize response" error There is an issue deserializing the UTXOs.
"error" error There is an issue creating the url with the esplora_url and address.

Sync SCL Balances

Code

const result = await wallet.sync_scl_balances_new();

Results

Output Type Description
{"Result":"Sync successful."} result The wallet has synced successfully.
{"Error":"Error listing utxos."} error There is an issue with the unspent UTXOs.
{"Error":"Database error."} error There is an issue with the indexedDB.
{"Error":"Failed to get result."} error There is an issue checking the UTXOs.
"Unable to deserialize response" error There is an issue deserializing the UTXOs.

BTC

Get Balance

Code

const result = wallet.get_balance();

Results

Output Type Description
{"confirmed":95900,"unconfirmed":0} result The confirmed and unconfirmed balances of BTC.
{"Error":"Wallet not initialized."} error The wallet is not initialized.

Send BTC

Parameters

Parameter Type Description Example
addresses string The addresses to send to. Seperate multiple addresses by a space. "tb1qgc0pnx734s3kt8n875u2cqtum0vrk5re3nfrj3"
amount string The send amount in sats. Seperate multiple amounts by a space. "10000"
fee int_64 The transaction fee worked out in estimate_fee_btc. 420

Code

const result = await wallet.send_btc(addresses, sats_amount, fee);

Results

Output Type Description
{"Result":"839efc9745c9e3711831f7e3c0fb848470108455f9f2c540c148d796a7dbeb21"} result The transaction ID of the send transaction.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.
{"Error":"Wallet not initialized."} error The wallet is not initialized.
{"Error":"Database error."} error There is an issue with the indexedDB.
{"Error":"Failed to parse address."} error The format of the address is incorrect.
{"Error":"Failed to parse amount."} error The format of the amount is incorrect.
{"Error":"Insufficient funds."} error There is insufficient BTC to make this send transaction.
{"Error":"Failed to deserialize transaction."} error There is an issue deserializing the send transaction.
{"Error":"Failed to broadcast transaction."} error There is an issue broadcasting the send transaction.

Get BTC Transaction History

Code

const result = await wallet.get_btc_tx_history();

Results

Output Type Description
see example json below result The transaction history for BTC.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.
{"Error":"Wallet not initialized."} error The wallet is not initialized.
error response error 
[
  {
    "txid": "ed01c5898573a44cec52f8ceb18f6b8f70cb9d1bd7d2c88da1e644b13e678ffa",
    "version": 2,
    "locktime": 0,
    "vin": [
      {
        "txid": "87d03eee9ce5b6a5cbf08ca07f9b81eaedf7229b0a3f94f1b08b48ed19d09975",
        "vout": 2,
        "prevout": {
          "scriptpubkey": "00147feb6476a7b287abb1d049da763071a686030dc0",
          "scriptpubkey_asm": "OP_0 OP_PUSHBYTES_20 7feb6476a7b287abb1d049da763071a686030dc0",
          "scriptpubkey_type": "v0_p2wpkh",
          "scriptpubkey_address": "tb1q0l4kga48k2r6hvwsf8d8vvr356rqxrwq82m6sh",
          "value": 550
        },
        "scriptsig": "",
        "scriptsig_asm": "",
        "witness": [
          "304402201b94e03fe9d1bc8ca7239b874e02a80057c5e7e8a18afd198223d950f5dc58870220542679a3127daadb5fd8941981710a5a8709ca669569cefcacea672b83a0237001",
          "023089049796ed85da5d03eaadf85436973516d326aa38e84bcaeaacc9add4c8eb"
        ],
        "is_coinbase": false,
        "sequence": 4294967295
      },
      {
        "txid": "87d03eee9ce5b6a5cbf08ca07f9b81eaedf7229b0a3f94f1b08b48ed19d09975",
        "vout": 3,
        "prevout": {
          "scriptpubkey": "00147feb6476a7b287abb1d049da763071a686030dc0",
          "scriptpubkey_asm": "OP_0 OP_PUSHBYTES_20 7feb6476a7b287abb1d049da763071a686030dc0",
          "scriptpubkey_type": "v0_p2wpkh",
          "scriptpubkey_address": "tb1q0l4kga48k2r6hvwsf8d8vvr356rqxrwq82m6sh",
          "value": 97950
        },
        "scriptsig": "",
        "scriptsig_asm": "",
        "witness": [
          "3045022100ab0a85c7f4a0631fb3a070d65efaef50495f9b90ce032f4e2d04afb06acde8d1022000c193034f3163fbb534f42739ae5f070f44f46d500cfdf254f77e146e3ccfb501",
          "023089049796ed85da5d03eaadf85436973516d326aa38e84bcaeaacc9add4c8eb"
        ],
        "is_coinbase": false,
        "sequence": 4294967295
      }
    ],
    "vout": [
      {
        "scriptpubkey": "0014463cbe41a13b4f071f895e92c89901db245cddb0",
        "scriptpubkey_asm": "OP_0 OP_PUSHBYTES_20 463cbe41a13b4f071f895e92c89901db245cddb0",
        "scriptpubkey_type": "v0_p2wpkh",
        "scriptpubkey_address": "tb1qgc7tusdp8d8sw8uft6fv3xgpmvj9ehdsmgwv8m",
        "value": 550
      },
      {
        "scriptpubkey": "6a208ff36829d648827b72caa4a693664a35b80b2b0c07c7e1bfa2f0749a2deb68a0",
        "scriptpubkey_asm": "OP_RETURN OP_PUSHBYTES_32 8ff36829d648827b72caa4a693664a35b80b2b0c07c7e1bfa2f0749a2deb68a0",
        "scriptpubkey_type": "op_return",
        "value": 0
      },
      {
        "scriptpubkey": "00147feb6476a7b287abb1d049da763071a686030dc0",
        "scriptpubkey_asm": "OP_0 OP_PUSHBYTES_20 7feb6476a7b287abb1d049da763071a686030dc0",
        "scriptpubkey_type": "v0_p2wpkh",
        "scriptpubkey_address": "tb1q0l4kga48k2r6hvwsf8d8vvr356rqxrwq82m6sh",
        "value": 550
      },
      {
        "scriptpubkey": "00147feb6476a7b287abb1d049da763071a686030dc0",
        "scriptpubkey_asm": "OP_0 OP_PUSHBYTES_20 7feb6476a7b287abb1d049da763071a686030dc0",
        "scriptpubkey_type": "v0_p2wpkh",
        "scriptpubkey_address": "tb1q0l4kga48k2r6hvwsf8d8vvr356rqxrwq82m6sh",
        "value": 95900
      }
    ],
    "size": 445,
    "weight": 1129,
    "fee": 1500,
    "status": {
      "confirmed": true,
      "block_height": 2576116,
      "block_hash": "00000000016d66d2436ce1a2923c6d59434906827ca077d457e2bc04d60488dc",
      "block_time": 1706536149
    }
  }
]

SCL

Get SCL Balance

Code

const result = wallet.get_scl_balance();

Results

Output Type Description
result The confirmed and unconfirmed balances of all SCL assets.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.
{"Error":"Wallet not initialized."} error The wallet is not initialized.
error response error

Send SCL

Parameters

Parameter Type Description Example
addresses string The addresses to send to. Seperate multiple addresses by a space. "tb1qgc0pnx734s3kt8n875u2cqtum0vrk5re3nfrj3"
amount string The send amount in SCL. Seperate multiple amounts by a space. "10000"
contract_id string The ID of the contract. "792965f15b1d4254e547681832b9bdc3feb411bf2d80ce1a6b6bb22793880b6b"
fee int_64 The fee worked out in estimate_fee_scl. 420

Code

const result = await wallet.send_scl(addresses, scl_amount, contract_id, fee);

Results

Output Type Description
{"Result":"892dd30adf026eea6d1c062af77405e441921c4907b0f77298ecdc8b18ec7c70"} result The transaction ID of the send transaction.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.
{"Error":"Wallet not initialized."} error The wallet is not initialized.
{"Error":"Database error."} error There is an issue with the indexedDB.
{"Error":"Failed to parse address."} error The format of the address is incorrect.
{"Error":"Failed to parse amount."} error The format of the amount is incorrect.
{"Error":"Contract not found."} error The contract ID is not in the wallet.
{"Error":"Insuffienct funds."} error There is insufficient SCL assets to make this send transaction.
{"Error":"Not enough BTC to cover fees."} error There is insufficient BTC to make this send transaction.
{"Error":"Failed to deserialize transaction."} error There is an issue deserializing the send transaction.
{"Error":"Failed to broadcast transaction."} error There is an issue broadcasting the send transaction.
{"Error":"Failed to broadcast payload."} error There is an issue broadcasting the send transaction.

Get Transaction History

Parameters

Parameter Type Description Example
contract_id string The ID of the contract being used. "792965f15b1d4254e547681832b9bdc3feb411bf2d80ce1a6b6bb22793880b6b"

Code

const result = await wallet.get_tx_history(contract_id);

Results

Output Type Description
result The transaction history for SCL assets.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.
{"Error":"Wallet not initialized."} error The wallet is not initialized.
{"Error":"Contract not found."} error The contract ID is not in the wallet.
error response error

Fees

Estimate Fee BTC

Parameters

Parameter Type Description Example
addresses string The addresses to send to. Seperate multiple addresses by a space. "tb1qgc0pnx734s3kt8n875u2cqtum0vrk5re3nfrj3"
amount string The send amount in BTC. Seperate multiple amounts by a space. "63210"
number_of_blocks int_32 The number of blocks for fee estimation. The lower the number, the higher the fee. 5

Code

const result = await wallet.estimate_fee_btc(addresses, amount, number_of_blocks);

Results

Output Type Description
{"Result":"585"} result The fee estimation for a BTC transaction.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.
{"Error":"Failed to parse address."} error The format of the address is incorrect.
{"Error":"Failed to parse amount."} error The format of the amount is incorrect.

Estimate Fee SCL

Parameters

Parameter Type Description Example
addresses string The addresses to send to. Seperate multiple addresses by a space. "tb1qgc0pnx734s3kt8n875u2cqtum0vrk5re3nfrj3"
amount string The send amount in SCL. Seperate multiple amounts by a space. "125 150 4500"
contract_id string The id of the contract being used. "792965f15b1d4254e547681832b9bdc3feb411bf2d80ce1a6b6bb22793880b6b"
number_of_blocks int_32 The number of blocks for fee estimation. The lower the number, the higher the fee. 5

Code

const result = await wallet.estimate_fee_scl(addresses, amount, contract_id, number_of_blocks);

Results

Output Type Description
{"Result":"1685"} result The fee estimation to send this SCL transaction.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.
{"Error":"Failed to parse address."} error The format of the address is incorrect.
{"Error":"Failed to parse amount."} error The format of the amount is incorrect.
{"Error":"Contract not found."} error The contract ID is not in the wallet.

Estimate Fee Mint

Parameters

Parameter Type Description Example
number_of_blocks int_32 The number of blocks for fee estimation. The lower the number, the higher the fee. 5

Code

const result = await wallet.estimate_fee_mint(number_of_blocks);

Results

Output Type Description
{"Result":"1135"} result The fee estimation to make this mint.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.

Estimate Fee List

Parameters

Parameter Type Description Example
list_order_json string A list of listings containing contract_id, amount, price_per_token. see example json below
number_of_blocks int_32 The number of blocks for fee estimation. The lower the number, the higher the fee. 5 
{
    "contract_id": "de3e6478bf37224a58be08ab7b8b7094400e0edcff5a829248b1fd02f5d7f0e1",
    "amount": 100000,
    "price_per_token": 2500
},
{
    "contract_id": "09f590fc69175307307af184c2c53358a40630eddce420a45b14a959b8d03bd3",
    "amount": 100000,
    "price_per_token": 2500
}

Code

const result = await wallet.estimate_fee_list(list_order_json, number_of_blocks);

Results

Output Type Description
{"Result":"2270 585"} result The fee estimation to make this listing. The actual fee followed by the hard fee.
{"Error":"Failed to deserialize list order json object."} error The list order json failed to deserialize.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.
{"Error":"Contract not found."} error The contract ID is not in the wallet.

Estimate Fee List Cancel

Parameters

Parameter Type Description Example
listing_utxo string The UTXO the listing is bound to. "dba8b3df2aaaa9c9a9e61a4ac61f2fabe5bd6cb2682dc4a17cbf9af3ae16e548"
number_of_blocks int_32 The number of blocks for fee estimation. The lower the number, the higher the fee. 5

Code

const result = await wallet.estimate_fee_cancel_listing(list_order_json, number_of_blocks);

Results

Output Type Description
{"Result":"1100"} result The fee estimation to cancel this listing.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.
{"Error":"Listing UTXO not in cabinet."} error The listing has already been successfully bid on.

Estimate Fee Bid

Parameters

Parameter Type Description Example
bid_order_json string A list of bids containing a list of contracts with their associated orders. see example json below
number_of_blocks int_32 The number of blocks for fee estimation. The lower the number, the higher the fee. 5 
{
    "contract_id": "de3e6478bf37224a58be08ab7b8b7094400e0edcff5a829248b1fd02f5d7f0e1",
    "orders": [
        {
            "order_id": "06d9a1a4b1c6a622de362a51567b010979898aa9891ca71a5a56596dbfbc38e8",
            "purchase_amount": 100000,
            "purchase_price": 2500,
            "pay_address": "tb1qategau6gdfakhhf4n23dtg47eht6225ypfcvv2",
            "listing_utxo": "dba8b3df2aaaa9c9a9e61a4ac61f2fabe5bd6cb2682dc4a17cbf9af3ae16e548:1"
        },
        {
            "order_id": "25bf5e449ccb2c817e2323b571f96f694ff53c89cca88dd40ec93bf83d2eb443",
            "purchase_amount": 10000,
            "purchase_price": 4500,
            "pay_address": "tb1qategau6gdfakhhf4n23dtg47eht6225ypfcvv2",
            "listing_utxo": "dba8b3df2aaaa9c9a9e61a4ac61f2fabe5bd6cb2682dc4a17cbf9af3ae16e548:1"
        }
    ]
}

Code

const result = await wallet.estimate_fee_bid(bid_order_json, number_of_blocks);

Results

Output Type Description
{"Result":"585"} result The fee estimation for bidding on this listing.
{"Error":"Failed to deserialize bid order json object."} error The bid order json failed to deserialize.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.
{"Error":"Contract not found."} error The contract ID is not in the wallet.

Estimate Fee Bid Cancel

Parameters

Parameter Type Description Example
number_of_blocks int_32 The number of blocks for fee estimation. The lower the number, the higher the fee. 5

Code

const result = await wallet.estimate_fee_cancel_bid(number_of_blocks);

Results

Output Type Description
{"Result":"585"} result The fee estimation for cancelling this bid.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.

Estimate Fee Airdop

Parameters

Parameter Type Description Example
number_of_airdops int_32 The number of airdrops. 125
number_of_blocks int_32 The number of blocks for fee estimation. The lower the number, the higher the fee. 5

Code

const result = await wallet.estimate_fee_airdrop(number_of_airdops, number_of_blocks);

Results

Output Type Description
{"Result":"16141"} result The fee estimation to claim this airdrop.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.

Contracts

Import Contract

Parameters

Parameter Type Description Example
contract_json string The serialized json of the contract. see example json below 
{
    "contract_id":"bdcdc39f36353082e4bc1025bb45ab7a50afe07950355a1fed4640ce8f469b60",
    "ticker":"TEST 200",
    "rest_url":"http://13.23.87.456:8080/",
    "contract_type":"SCL01",
    "decimals":8
}

Code

const result = await wallet.import_contract(contract_json);

Results

Output Type Description
{"Result":"Import successful."} result The contract was imported successfully.
{"Error":"Database error."} error There is an issue with the indexedDB.

Delete Contract

Parameters

Parameter Type Description Example
contract_id string The id of the contract to be deleted. "792965f15b1d4254e547681832b9bdc3feb411bf2d80ce1a6b6bb22793880b6b"

Code

const result = await wallet.delete_contract(contract_id);

Results

Output Type Description
{"Result":"Delete successful."} result The contract was deleted successfully.
{"Error":"Database error."} error There is an issue with the indexedDB.
{"Error":"Contract doesn't exist in db."} error The contract does not exist in the wallet.

Get Contract

Parameters

Parameter Type Description Example
contract_id string The id of the contract to get. "792965f15b1d4254e547681832b9bdc3feb411bf2d80ce1a6b6bb22793880b6b"

Code

const result = await wallet.get_contract(contract_id);

Results

Output Type Description
result The contract was gotten successfully.
{"Error":"Wallet not initialized."} error The wallet is not initialized.
{"Error":"Database error."} error There is an issue with the indexedDB.

Get Contracts

Code

const result = await wallet.get_contracts();

Results

Output Type Description
result The contracts were gotten successfully.
{"Error":"Wallet not initialized."} error The wallet is not initialized.
{"Error":"Database error."} error There is an issue with the indexedDB.

Minting

Mint SCL01 Contract

Parameters

Parameter Type Description Example
ticker string The name of the SCL asset. "SMOL"
max_supply string The max supply of SCL assets. "31415900000000"
decimals string The number of decimals the SCL asset has. "8"
fee int_64 The fee worked out in estimate_fee_mint. 1756

Code

const result = await wallet.mint_scl01_contract(ticker, max_supply, decimals, fee);

Results

Output Type Description
{"Result":"5e73fe53cf33648755899f9f8252d969d7d36808f7339f8fe67033b1430f9987"} result The transaction ID of the mint transaction.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.
{"Error":"Wallet not initialized."} error The wallet is not initialized.
{"Error":"Database error."} error There is an issue with the indexedDB.
{"Error":"Insufficient funds."} error There is insufficient BTC to mint this contract.
{"Error":"Failed to deserialize transaction."} error There is an issue deserializing the mint transaction.
{"Error":"Failed to broadcast transaction."} error There is an issue broadcasting the mint transaction.

Mint SCL02 Contract

Parameters

Parameter Type Description Example
ticker string The name of the SCL asset. "ELON"
max_supply string The max supply of SCL assets. "42069420690"
decimals string The number of decimals the SCL asset has. "8"
fee int_64 The fee worked out in estimate_fee_mint. 1756
airdrop_amount string The amount of SCL assets per airdop. 420690

Code

const result = await wallet.mint_scl02_contract(ticker, max_supply, decimals, fee, airdrop_amount);

Results

Output Type Description
{"Result":"0eebc6baa4463e8f0f9f8cf31440ed12e9f312671b334de97e338380ee1f5cc1"} result The transaction ID of the mint transaction.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.
{"Error":"Wallet not initialized."} error The wallet is not initialized.
{"Error":"Database error."} error There is an issue with the indexedDB.
{"Error":"Insufficient funds."} error There is insufficient BTC to mint this contract.
{"Error":"Failed to deserialize transaction."} error There is an issue deserializing the mint transaction.
{"Error":"Failed to broadcast transaction."} error There is an issue broadcasting the mint transaction.

Mint SCL03 Contract

Parameters

Parameter Type Description Example
ticker string The name of the SCL asset. "DFG"
decimals string The number of decimals the SCL asset has. "8"
address string The address of the minted assets. Seperate multiple addresses by a space. "tb1qlh458zyuv4kc9g4pawvczss0tz09ht0u28e7u3"
amount string The amount of SCL assets minted. Seperate multiple amounts by a space. "10000000000000000"
fee int_64 The fee worked out in estimate_fee_mint. 1756

Code

const result = await wallet.mint_scl03_contract(ticker, decimals, address, amount, fee);

Results

Output Type Description
{"Result":"adc110d77942e3e4ca9f2c585249a8d3b82d5b5a82563a0a01e9c591837d99d5"} result The transaction ID of the mint transaction.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.
{"Error":"Wallet not initialized."} error The wallet is not initialized.
{"Error":"Database error."} error There is an issue with the indexedDB.
{"Error":"Failed to parse address."} error There is an issue with the parsing one of the addresses.
{"Error":"Failed to parse amount."} error There is an issue with the parsing one of the amounts.
{"Error":"Insufficient funds."} error There is insufficient BTC to mint this contract.
{"Error":"Failed to deserialize transaction."} error There is an issue deserializing the mint transaction.
{"Error":"Failed to broadcast transaction."} error There is an issue broadcasting the mint transaction.

Right to Mint

Parameters

Parameter Type Description Example
rights_utxo string The UTXO that has the right to mint. ""
rights_address string The address that has the right to mint. ""
fee int_64 The fee worked out in estimate_fee_mint. 1756

Code

const result = await wallet.mint_token_rtm(rights_utxo, rights_address, fee);

Results

Output Type Description
{"Result":"005974de174aa8319ee829fafe25b5e43848ce3965970b228a7b64c8a5e9b522"} result The transaction ID of the right to mint transaction.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.
{"Error":"Wallet not initialized."} error The wallet is not initialized.
{"Error":"Failed to parse rights address."} error There is an issue with the parsing the rights address.
{"Error":"Contract not found."} error The contract ID is not in the wallet.
{"Error":"Insufficient funds."} error There is insufficient BTC to mint this contract.
{"Error":"Failed to deserialize transaction."} error There is an issue deserializing the mint transaction.
{"Error":"Failed to broadcast transaction."} error There is an issue broadcasting the mint transaction.
{"Error":"Failed to broadcast payload."} error There is an issue broadcasting the right to mint payload.

Listing

Create Listing

Parameters

Parameter Type Description Example
list_order_json string An array of listings. see example json below
fee int_64 The fee worked out in estimate_fee_list. The actual fee followed by the hard fee. "1756 585" 
{
    "contract_id": "de3e6478bf37224a58be08ab7b8b7094400e0edcff5a829248b1fd02f5d7f0e1",
    "amount": 100000,
    "price_per_token": 2500
},
{
    "contract_id": "09f590fc69175307307af184c2c53358a40630eddce420a45b14a959b8d03bd3",
    "amount": 100000,
    "price_per_token": 2500
}

Code

const result = await wallet.list_token_batch(list_order_json, fee);

Results

Output Type Description
{"Result":"c894c5c8ea21bfe8c9aa0d9295db235ad74ec307ed4a493c06dd0393288608f7"} result The transaction ID of the listing transaction.
{"Error":"Failed to deserialize list order json object."} error The list order json failed to deserialize.
{"Error":"Invalid fee estimation string."} error The format of the fee is incorrect.
{"Error":"Failed to parse fee."} error There is an issue parsing the actual/hard fee.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.
{"Error":"Wallet not initialized."} error The wallet is not initialized.
{"Error":"Database error."} error There is an issue with the indexedDB.
{"Error":"Contract not found."} error The contract ID is not in the wallet.
{"Error":"Insuffient token funds."} error There are not enough tokens to make this listing transaction.
{"Error":"Not enough BTC to cover fees."} error There is insufficient BTC to make this listing transaction.
{"Error":"Failed to deserialize transaction."} error There is an issue deserializing the listing transaction.
{"Error":"Failed to broadcast transaction."} error There is an issue broadcasting the listing transaction.
{"Error":"Failed to broadcast payload."} error There is an issue broadcasting the listing payload.

Cancel Listing

Parameters

Parameter Type Description Example
listing_utxo string The UTXO the listing is bound to. "dba8b3df2aaaa9c9a9e61a4ac61f2fabe5bd6cb2682dc4a17cbf9af3ae16e548"
fee int_64 The fee worked out in estimate_fee_list_cancel. 1756

Code

const result = await wallet.cancel_listing(listing_utxo, fee);

Results

Output Type Description
{"Result":"c6dee0b8c41255ddd4faba2916b37797a5c0632ba56fa597c72471fa8fde39f3"} result The transaction ID of the cancel listing transaction.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.
{"Error":"Wallet not initialized."} error The wallet is not initialized.
{"Error":"Database error."} error There is an issue with the indexedDB.
{"Error":"Listing UTXO not in cabinet."} error The listing has already been successfully bid on.
{"Error":"Not enough BTC to cover fees."} error There is insufficient BTC to make this cancel listing transaction.
{"Error":"Failed to deserialize transaction."} error There is an issue deserializing the cancel listing transaction.
{"Error":"Failed to broadcast transaction."} error There is an issue broadcasting the cancel listing transaction.
{"Error":"Failed to broadcast payload."} error There is an issue broadcasting the cancel listing payload.

Bidding

Create Bid

Parameters

Parameter Type Description Example
bid_order_json string An array of bids containing a array of contracts with their associated bids. see example json below
fee int_64 The fee worked out in estimate_fee_bid. 1756 
{
    "contract_id": "de3e6478bf37224a58be08ab7b8b7094400e0edcff5a829248b1fd02f5d7f0e1",
    "orders": [
        {
            "order_id": "06d9a1a4b1c6a622de362a51567b010979898aa9891ca71a5a56596dbfbc38e8",
            "purchase_amount": 100000,
            "purchase_price": 2500,
            "pay_address": "tb1qategau6gdfakhhf4n23dtg47eht6225ypfcvv2",
            "listing_utxo": "dba8b3df2aaaa9c9a9e61a4ac61f2fabe5bd6cb2682dc4a17cbf9af3ae16e548:1"
        },
        {
            "order_id": "25bf5e449ccb2c817e2323b571f96f694ff53c89cca88dd40ec93bf83d2eb443",
            "purchase_amount": 10000,
            "purchase_price": 4500,
            "pay_address": "tb1qategau6gdfakhhf4n23dtg47eht6225ypfcvv2",
            "listing_utxo": "dba8b3df2aaaa9c9a9e61a4ac61f2fabe5bd6cb2682dc4a17cbf9af3ae16e548:1"
        }
    ]
}

Code

const result = await wallet.place_bid_batch(bid_order_json, fee);

Results

Output Type Description
{"Result":"0195788746a3aef6d84385e908b4eb9328b98d1d08e0c7741ae8726c5d672d76"} result The transaction ID of the bid transaction.
{"Error":"Failed to deserialize bid order json object."} error The bid_order_json failed to deserialize.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.
{"Error":"Wallet not initialized."} error The wallet is not initialized.
{"Error":"Database error."} error There is an issue with the indexedDB.
{"Error":"Contract not found."} error The contract ID is not in the wallet.
{"Error":"Insuffient funds."} error There is insufficient BTC to make this listing transaction.
{"Error":"Failed to deserialize transaction."} error There is an issue deserializing the bid transaction.
{"Error":"Failed to broadcast transaction."} error There is an issue broadcasting the bid transaction.
{"Error":"Failed to broadcast payload."} error There is an issue broadcasting the bid payload.

Accept Bid

Parameters

Parameter Type Description Example
unsigned_tx_hex string "0200000001900327a4f57651ac442c35066dcaaa6e17de5c7510277b5fa42565a60fa6e87a0100000000ffffffff022602000000000000160014f3c7491bedda954b105ee60e7a32d7aee6e685860000000000000000226a20da1ecba9ebbf936b53c940a22e1bda3a16492871faa63054906d74a15a6de66c00000000"
fulfil_tx string "02000000000102b5ba860041b15437601ab4bf2c54ccf5d9f7ae757f08ac8a467b3c97f654bd350000000000ffffffff378695168ed4aa95bcf572b6250f91d7aaa85caa04a9330f3e188a0448d6cb660000000000ffffffff032602000000000000160014f3c7491bedda954b105ee60e7a32d7aee6e685862d00000000000000160014eaf28ef3486a7b6bdd359aa2d5a2becdd7a52a840000000000000000226a20ad18a45f73df467ffea6fcecbf1574b7841fda0fd1be948a48118f9583757f1902483045022100bfa467b40a6715079b7d3e07be92447de2e61c21458702d9b1365894f75591df0220429005625d57e4ea44d46459a2a0768d3732dce1c746d2cc801e8528c1a793580121036674a057f385a5a8a74dfbd457711f282b9ea28cb781422cbbd6b6f42d9ab6c702483045022100f5a73800f696a877d5f5194e3a3daefebc27601ddcbfeae5946ff0daca213ed802204fa7939d43efa79fd37758bf70288a7743d50a0b4ab10e17800f0b55763457030121036674a057f385a5a8a74dfbd457711f282b9ea28cb781422cbbd6b6f42d9ab6c700000000"
contract_id string "792965f15b1d4254e547681832b9bdc3feb411bf2d80ce1a6b6bb22793880b6b"

Code

const result = await wallet.accept_bid(unsigned_tx_hex, fulfil_tx, contract_id);

Results

Output Type Description
result The transaction ID of the accept bid transaction.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.
{"Error":"Invalid Accept TX."} error The unsigned_tx_hex is invalid.
{"Error":"Invalid Fulfil TX."} error The fulfil_tx is invalid.
{"Error":"Wallet not initialized."} error The wallet is not initialized.
{"Error":"Contract not found."} error The contract ID is not in the wallet.
{"Error":"Failed to deserialize tx."} error There is an issue deserializing the unsigned_tx_hex.
{"Error":"Failed to deserialize transaction."} error There is an issue deserializing the accept bid transaction.
{"Error":"Failed to broadcast transaction."} error There is an issue broadcasting the accept bid transaction.
{"Error":"Failed to broadcast payload."} error There is an issue broadcasting the accept bid payload.

Cancel Bid

Parameters

Parameter Type Description Example
bid_utxo string The UTXO the bid is bound to. "dba8b3df2aaaa9c9a9e61a4ac61f2fabe5bd6cb2682dc4a17cbf9af3ae16e548"
fee int_64 The fee worked out in estimate_fee_bid_cancel. 1756

Code

const result = await wallet.cancel_bid(bid_utxo, fee);

Results

Output Type Description
{"Result":"243afbb1aa0c3e04f8b165416d3ee02ce175f22dae1b997d7ba06d12e88e388f" result The transaction ID of the cancel bid transaction.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.
{"Error":"Wallet not initialized."} error The wallet is not initialized.
{"Error":"Database error."} error There is an issue with the indexedDB.
{"Error":"Bidding UTXO not in cabinet."} error The bid has already been successfully accepted.
{"Error":"Not enough BTC to cover fees."} error There is insufficient BTC to make this cancel bid transaction.
{"Error":"Failed to deserialize transaction."} error There is an issue deserializing the cancel bid transaction.
{"Error":"Failed to broadcast transaction."} error There is an issue broadcasting the cancel bid transaction.
{"Error":"Failed to broadcast payload."} error There is an issue broadcasting the cancel bid payload.

Airdrop

Claim Airdrop

Parameters

Parameter Type Description Example
contract_ids string The IDs of the contracts that is being claimed. Seperate multiple contracts by a space. "09f590fc69175307307af184c2c53358a40630eddce420a45b14a959b8d03bd3"
fee int_64 The fee worked out in estimate_fee_airdop. 1756

Code

const result = await wallet.airdrop(contract_ids, fee);

Results

Output Type Description
{"Result":"04affa741549ea4f9f2f331a36f83906b558862bf2e70bef833ef1f8e14bc3f2"} result The transaction ID of the claim airdrop transaction.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.
{"Error":"Wallet not initialized."} error The wallet is not initialized.
{"Error":"Database error."} error There is an issue with the indexedDB.
{"Error":"Insufficient funds."} error There is insufficient BTC to make this claim airdrop transaction.
{"Error":"Failed to deserialize transaction."} error There is an issue deserializing the claim airdrop transaction.
{"Error":"Failed to broadcast transaction."} error There is an issue broadcasting the claim airdrop transaction.
{"Error":"Failed to broadcast payload."} error There is an issue broadcasting the claim airdrop payload.

Create Diminishing Airdrop

Parameters

Parameter Type Description Example
contract_id string The ID of the contract. "3b1b20518485ec89ce9acf5bb23c5ccdb0ac26d0661e377014e894d295eec29e"
pool_amount string The total amount available to be airdropped. "40000000000000"
stepdown_amount string The amount the airdrop diminishes by per step. "10"
stepdown_period string The amount of claims before the airdrop diminishes. "160"
max_amount string The first airdrop amount that will be received at the beginning of the stepdown period. "250"
min_amount string The last airdrop amount that will be received at the end of the stepdown period. "50"
single_drop string Indicates if multiple claims can be made from one address or not. Either true/false. "true"
fee int_64 The fee worked out in estimate_fee_scl. 1756

Code

const result = await wallet.create_diminishing_airdrop(contract_id, pool_amount, stepdown_amount, stepdown_period, max_amount, min_amount, single, fee);

Results

Output Type Description
{"Result:"06d9a1a4b1c6a622de362a51567b010979898aa9891ca71a5a56596dbfbc38e8"} result The transaction ID of the create diminishing airdrop transaction.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.
{"Error":"Wallet not initialized."} error The wallet is not initialized.
{"Error":"Database error."} error There is an issue with the indexedDB.
{"Error":"Contract not found."} error The contract ID is not in the wallet.
{"Error":"Insufficient funds."} error There is insufficient SCL to make this create diminishing airdrop transaction.
{"Error":"Not enough BTC to cover fees."} error There is insufficient BTC to make this create diminishing airdrop transaction.
{"Error":"Failed to deserialize transaction."} error There is an issue deserializing the create diminishing airdrop transaction.
{"Error":"Failed to broadcast transaction."} error There is an issue broadcasting the create diminishing airdrop transaction.
{"Error":"Failed to broadcast payload."} error There is an issue broadcasting the create diminishing airdrop payload.

Claim Diminishing Airdrop

Parameters

Parameter Type Description Example
contract_id string The ID of the contract. ""
dimairdop_id string The ID of the Diminishing Airdrop. ""
fee int_64 The fee worked out in estimate_fee_airdrop. 685

Code

const result = await wallet.claim_diminishing_airdrop(contract_id, dimairdop_id, fee);

Results

Output Type Description
{"Result:"5af05854e32ee9f92315253b1606d3bb82b7683f0b56456b9744a5d9b0e7951f"} result The transaction ID of the claim diminishing airdrop transaction.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.
{"Error":"Wallet not initialized."} error The wallet is not initialized.
{"Error":"Database error."} error There is an issue with the indexedDB.
{"Error":"Contract not found."} error The contract ID is not in the wallet.
{"Error":"Insufficient funds."} error There is insufficient BTC to make this claim diminishing airdrop transaction.
{"Error":"Failed to deserialize transaction."} error There is an issue deserializing the claim diminishing airdrop transaction.
{"Error":"Failed to broadcast transaction."} error There is an issue broadcasting the claim diminishing airdrop transaction.
{"Error":"Failed to broadcast payload."} error There is an issue broadcasting the claim diminishing airdrop payload.

Drips

Create Drip

Parameters

Parameter Type Description Example
addresses string The addresses to drip to. Seperate multiple addresses by a space. "tb1qgc0pnx734s3kt8n875u2cqtum0vrk5re3nfrj3"
amount string The drip amount in sats. Seperate multiple amounts by a space. "10000"
contract_id string The ID of the contract. "3b1b20518485ec89ce9acf5bb23c5ccdb0ac26d0661e377014e894d295eec29e"
duration string The amount of blocks the drip will be active for "12960"
fee int_64 The fee worked out in estimate_fee_scl. 1756

Code

const result = await wallet.drip_scl(addresses, amount, contract_id, duration, fee);

Results

Output Type Description
result The transaction ID of the create drip transaction.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.
{"Error":"Wallet not initialized."} error The wallet is not initialized.
{"Error":"Database error."} error There is an issue with the indexedDB.
{"Error":"Failed to parse address."} error The format of the address is incorrect.
{"Error":"Failed to parse amount."} error The format of the amount is incorrect.
{"Error":"Contract not found."} error The contract ID is not in the wallet.
{"Error":"Insufficient funds."} error There is insufficient SCL to make this create drip transaction.
{"Error":"Not enough BTC to cover fees."} error There is insufficient BTC to make this create drip transaction.
{"Error":"Failed to deserialize transaction."} error There is an issue deserializing the create drip transaction.
{"Error":"Failed to broadcast transaction."} error There is an issue broadcasting the create drip transaction.
{"Error":"Failed to broadcast payload."} error There is an issue broadcasting the create drip payload.

Create DGE

Parameters

Parameter Type Description Example
contract_id string The ID of the contract. "3b1b20518485ec89ce9acf5bb23c5ccdb0ac26d0661e377014e894d295eec29e"
pool_amount string The total amount of tokens put up for DGE. "700000000000000"
sats_rate string The amount of sats exchanged per token. "5351"
max_drop string The upper limit (in tokens) per drop. "70000000000"
drip_duration string How long the drip should last measured in number of blocks. "12960"
donation_address string The address the donations go to. "tb1qlh458zyuv4kc9g4pawvczss0tz09ht0u28e7u3"
single_drop string Indicates if multiple claims can be made from one address or not. Either true/false. "true"
fee int_64 The fee worked out in estimate_fee_scl. 1756

Code

const result = await wallet.create_dge(contract_id, pool_amount, sats_rate, max_drop, drip_duration, donation_address, single_drop, fee);

Results

Output Type Description
{"Result":"8c6be55f904d5711b6a3edb7921981fcdbe4e9b67c98ac06e0c0b9b121dc070c"} result The transaction ID of the create dge transaction.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.
{"Error":"Wallet not initialized."} error The wallet is not initialized.
{"Error":"Database error."} error There is an issue with the indexedDB.
{"Error":"Contract not found."} error The contract ID is not in the wallet.
{"Error":"Insufficient funds."} error There is insufficient SCL to make this create dge transaction.
{"Error":"Not enough BTC to cover fees."} error There is insufficient BTC to make this create dge transaction.
{"Error":"Failed to deserialize transaction."} error There is an issue deserializing the create dge transaction.
{"Error":"Failed to broadcast transaction."} error There is an issue broadcasting the create dge transaction.
{"Error":"Failed to broadcast payload."} error There is an issue broadcasting the create dge payload.

Claim DGE

Parameters

Parameter Type Description Example
contract_id string The ID of the contract. "3b1b20518485ec89ce9acf5bb23c5ccdb0ac26d0661e377014e894d295eec29e"
dge_id string The first spender UTXO from the create dge command. "782f9b6e1329a400bb0f6dc3b678a1b3a0c3a8186b44d5cd7b82b19478264548:0"
donation_address string The address the donations go to. "tb1qlh458zyuv4kc9g4pawvczss0tz09ht0u28e7u3"
amount string The amount that is getting donated in sats. "45000"
fee int_64 The fee worked out in estimate_fee_airdrop. 1756

Code

const result = await wallet.claim_dge(contract_id, dge_id, donation_address, amount, fee);

Results

Output Type Description
{"Result":"45dde82c8282be5c59c65456d7e2b6111fd66426fd59bb87d53bb94bc1e56dba"} result The transaction ID of the claim dge transaction.
{"Error":"Wallet needs to sync."} error The wallet has not synced yet.
{"Error":"Wallet not initialized."} error The wallet is not initialized.
{"Error":"Failed to parse donation address."} error There is an issue with the parsing the donation address.
{"Error":"Database error."} error There is an issue with the indexedDB.
{"Error":"Contract not found."} error The contract ID is not in the wallet.
{"Error":"Insufficient funds."} error There is insufficient VTC to make this claim dge transaction.
{"Error":"Failed to deserialize transaction."} error There is an issue deserializing the claim dge transaction.
{"Error":"Failed to broadcast transaction."} error There is an issue broadcasting the claim dge transaction.
{"Error":"Failed to broadcast payload."} error There is an issue broadcasting the claim dge payload.

Utilities

New Address

Code

const result = wallet.new_address();

Results

Output Type Description
{"Result":"tb1qgc0pnx734s3kt8n875u2cqtum0vrk5re3nfrj3"} result The address of the wallet.
{"Error":"Wallet not initialized."} error The address is invalid.

Is Address

Parameters

Parameter Type Description Example
address string The address of the wallet. "tb1qgc0pnx734s3kt8n875u2cqtum0vrk5re3nfrj3"

Code

const result = wallet.is_address(address);

Results

Output Type Description
true result The address is valid.
false result The address is invalid.