Stellar

Stellar

Stellar can be accessed with the following coin types:

Environment	Coin Type	Faucet
Stellar Production	xlm
Stellar Testnet	txlm	https://www.stellar.org/laboratory/#account-creator?network=test

Explorer

https://stellarchain.io/

Generating wallets

bitgo
  .coin('txlm')
  .wallets()
  .generateWallet({
    label: 'My Test Wallet',
    passphrase: 'secretpassphrase1a5df8380e0e30',
  })
  .then(function (wallet) {
    // print the new wallet
    console.dir(wallet);
  });

LABEL="My Test Wallet"
PASSPHRASE="secretpassphrase1a5df8380e0e30"

curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-d "{ \"label\": \"$LABEL\", \"passphrase\": \"$PASSPHRASE\" }" \
http://$BITGO_EXPRESS_HOST/api/v2/txlm/wallet/generate

Before you can use a Stellar wallet, you must initialize it on the Stellar blockchain. You must first send a funding transaction to the wallet address. When BitGo detects this funding transaction, it automatically sends another initialization transaction to set up the signers and the home domain of the account.

Until the network confirms the initialization transaction, the wallet is not ready for use, and the API does not expose the receive address. This is to protect users from losing assets by sending to a wallet that does not exist on the network.

Stellar accounts must maintain a minimum balance. See Stellar Balances.

Required reserve

curl -X GET \
-H "Authorization: Bearer $ACCESS_TOKEN" \
https://app.bitgo-test.com/api/v2/txlm/requiredReserve

Fetch information about reserve requirements for an account. See Stellar Balances.

HTTP Request

GET /api/v2/:coin/requiredReserve

HTTP Response

Field	Description
baseFee	base fee used in transaction fees.
baseReserve	base reserve used in minimum account balances.
height	the height of the block that provides the base values.
minimumFunding	minimum funding balance, calculated using reserve and base fee.
reserve	minimum account balance, calculated using base reserve.

Creating addresses

bitgo
  .coin('txlm')
  .wallets()
  .getWallet({ id: '585c51a5df8380e0e3082e46' })
  .then(function (wallet) {
    return wallet.createAddress();
  })
  .then(function (newAddress) {
    // print new address details
    console.dir(newAddress);
  });

WALLET=585c51a5df8380e0e3082e46

curl -X POST \
-H "Authorization: Bearer $ACCESS_TOKEN" \
https://app.bitgo-test.com/api/v2/txlm/wallet/$WALLET/address

The BIP-32 standard does not apply here, and hence generated XLM addresses differ only in their sequentially incrementing memo id components. The memo type used by BitGo is MEMO_ID: a 64-bit unsigned numeric string. Whenever you create a new address, the address coinSpecific property contains the incremented memoId and the rootAddress.

Balances

Lumen (XLM) is the native asset of the Stellar blockchain. The base unit of Lumen is stroop:

• 1 stroop is 10 -7 or 0.0000001 Lumen.
• 1 Lumen is 10 7 or 10000000 stroop (10 million).

The API supports balances in string format: balanceString, confirmedBalanceString, spendableBalanceString, and seqIdString.

NOTE: If you provide a memoId on the address, balances only return seqIdString.

All Stellar accounts must maintain a minimum balance of lumens. The base reserve, which is currently 0.5 XLM, determines the minimum balance. The absolute minimum balance for an account is 1 XLM, which is equal to (2 + 0 entries) * 0.5 base reserve. Each additional entry reserves an additional 0.5 XLM.

Base fee

Stellar has a base fee that a VCG auction determines dynamically. When you submit a transaction to the network, you specify the maximum base fee you’re willing to pay per operation, but Stellar charges you the lowest possible fee based on network activity.

When network activity is below capacity, you pay the network minimum, which is currently 100 stroops (0.00001 XLM) per operation.

Transactions

Stellar uses an account-based model, similar to XRP. Additionally, due to the use of memo, Stellar transactions only support one input and one output.

BitGo's XLM multisig contract currently only supports one sender and one recipient so the sendMany is not supported.

Federation

BitGo supports the Stellar federation protocol that matches Stellar addresses to Stellar accounts. Additionally, the BitGo federation server provides the next memo id for the wallet. Stellar accounts can be looked up by their Stellar address or their account ID.

Users can create email-like usernames for their Stellar wallets. A Stellar address consists of the Stellar username and the account home domain (for example, test*bitgo.com).

Stellar usernames are unique, and only accept lower-case letters, numbers, and the characters: -_.+@. BitGo automatically sets the home domain to bitgo.com. A Stellar username can only be set once the wallet initializes, and it cannot be changed. See Update Wallet.