quick tips for devs

Quick Tips for BitShares Developers

This guide is intended for developers who will be using the existing BitShares Core platform. Detailed documentation can be found at the following resources.

• Developer documentation
• General Documentation

Quick tips for common developer actions are linked to below.

---

Table of Contents

• Accounts, Permissions, and Authorities
• Standard Transactions
• Proposed Transactions
• User Issued Assets
• Vesting Balances
• Hashed Time-Lock Contracts
• Software Tools
• Configuration for Testnet

---

Accounts, Permissions, and Authorities

• About Accounts
• About Account Permissions
• About Dynamic Account Permissions
• About Multi-Signature Authorities
• How to change account authority thresholds (GUI)
• How to register an account
• How to import a GUI-wallet account into the CLI-wallet
• How to generate a random key in the CLI

Standard Transactions

Transactions allow multiple operations to be performed atomically within BitShares

• How to construct a transaction in the CLI wallet
• Tips about transactions

Proposed Transactions

Proposed transaction are useful for performing actions on the blockchain that require approval of multiple accounts.

• About Proposed Transactions
• How to create a proposed transaction
• How to approve a proposed transaction

User-Issued Assets (UIA)

• About User-Issued Assets
• How to create a UIA in the GUI
• How to create a UIA in the CLI (Example)
• How to create parent.child assets
• How to update an existing UIA
• How can the issuer issue a UIA
• How can the issuer retract a UIA
• How can the issuer burn a UIA (CLI)

Vesting Balances

• About vesting balances
• Example of vesting balances with CryptoBridge
• How to create vesting balance
• How to check a vesting balance
• Example of supplementing payouts for vesting balances
• How to claim a vesting balance (CLI)
• How to claim a vesting balance (GUI Wallet)

Hashed Time-Lock Contracts (HTLC)

• How to create and redeem an HTLC (CLI)

Software Tools

API Calls

• How to make one-off API calls
• About Remote Procedure Call API
• How to subscribe to object data with websockets

Software Clients and Libraries

• Open Source GUI Wallets
• Open Source Command Line Wallets
  • CLI Wallet (C++)
  • Uptick (Python)
• Open Source Libraries
• Open Source Tools

How to Configure Software for Testnet

Reference Wallet

The GUI reference wallet, which is also hosted by several parties, can be connected to any testnode under Settings.

Command Line Interface Wallet (CLI)

• The CLI Wallet (C++) must
  • have been built from the testnet branch
  • be configured to point to a public API node by using the -s switch

cli_wallet -s ws://<HOST_NAME_OR_IP>:<HOST_PORT>

or if using a secure connection

cli_wallet -s wss://<HOST_NAME_OR_IP>:<HOST_PORT>

Python Wallet

Uptick is a Python-based CLI tool set for BitShares blockchain. Documentation can be found here.

It can be configured to connect to the public testnet by setting any testnet API node. For example

uptick set node wss://testnet.nodes.bitshares.ws

DEXBot

DEXBot is a market maker bot that can be configured to point to a testnet API node by leaving it as the only API node in the configuration file.