stellar-suite

v0.17.0

Published

2 years ago

Useful libarary wrapped of js-stellar-sdk. very easy, useful

Downloads

0High
0Medium
0Low

fukaoi

common lib blockchain stellar js-stellar-sdk sdk

stellar-suite

stellar-suite is a JS library to handle stellar easily and usefully. It wraps js-stellar-sdk within. Payment and multisig transactions tend to be complicated JS code, but you can implement them easily by using stellar-suite. MemoText can be added to a transaction, but the limit 28-byte . This limit is cleared by working with Ethereum SWAM.

How to install

npm install stellar-suite

The difference development(test) test and production enviroment

development

Node.js setting
Build command for Built in HTML JS
```
npm run build
```
js file for Built in HTML JS
```
dist/browser/stellar-suite-dev.js
```
Stellar Network is Testnet
Etereum Swarm is Mainnet (Because swarm is only mainnet)

production

Node.js setting
```
NODE_ENV=production app.js
```
Build command for Built in HTML JS
```
npm run build.prd
```
js file for Built in HTML JS
```
dist/browser/stellar-suite.js
```
Stellar Network is Mainnet
Etereum Swarm is Mainnet (Because swarm is only mainnet)

Usage

See src/__test__/*.test.ts for more information.

Node.js, ES6, Built in HTML

Node.js

const {
  Account,
  Token,
  Payment,
  Multisig,
  Storage,
} = require('stellar-suite');

import Stellar,{
  Account,
  Token,
  Payment,
  Multisig,
  Storage,
} from 'stellar-suite';

Built in HTML(notice: development is stellar-suite-dev.js)

<html>

<head>
  <script type="text/javascript" src="../../dist/browser/stellar-suite.js">
  </script>
</head>

<body>
  <script>
    (async () => {
      // Get transaction by stream data
      const pubkey = 'GCKFBEIYV2U22IO2BJ4KVJOIP7XPWQGQFKKWXR6DOSJBV7STMAQSMTGG';
      const fn = StellarSuite.Transaction.stream(pubkey, console.log)();
    })();
  </script>
</body>

</html>

Modules description

- Account -

Account.create()()

create account

Account.createTestnet()

create account for testnet


Account.create('must params')('optional params')

|optional param |description | |----------|--------------------------| |memo(Memo)|MemoType Object| |feeSource| for delegate account when want use feeBump function| |feeMultiplication| default=100. 100 * feeMultiplication| |timeout|set transaction timeout|

development

const {Account} = require('stellar-suite');

(async() => {
  const res = await Account.createTestnet();
  console.log(res);
})();


/* response
{
  pubkey: 'GDCVRRVJVSM7GRKTENFQUGNZA6KPRHP7Q6KXA2P7CCACKA5XMYU4PW2F',
  secret: 'SCBIJIGN2RLFTZQ52PRA3GRG2GHJVDTWTWIRNA7FG5BMGJSCZ546L2KQ'
}
*/

production

const {Account} = require('stellar-suite');

const creatorSec = 'SD4WH2AE5EBE72K4BIX5GLFVASV45HKRIA5MXVDJ7MNPMMXCGIJZX5SN';

(async() => {
 const res = await Account.create(creatorSec)();
  console.log(res);
})();


/* response
{
  pubkey: 'GDCVRRVJVSM7GRKTENFQUGNZA6KPRHP7Q6KXA2P7CCACKA5XMYU4PW2F',
  secret: 'SCBIJIGN2RLFTZQ52PRA3GRG2GHJVDTWTWIRNA7FG5BMGJSCZ546L2KQ'
}
*/

All set params that must param and optional param


const {
  Account,
  Memo
} = require('stellar-suite');

const createtor = {
  pubkey: 'GBFCIBLNLSSIM4L662UTIVSMF2CDGM3U7VRMM7D6ECZAKQRSPDRIYKZW',
  secret: 'SDSIMAPJJC3K4EODTIZGQEKLKSIR2YE2R73V77X6LWVDRLJ5W73EFKW2'
};

const feeSource ={
  pubkey: 'GAOLT2JOFLPGVMHI56F6D6UIFJROTZ3O47APWBR3JNOYKXFCZ5TL2QDG',
  secret: 'SCNFMAJ236JZSPFFTKTZCEDWXCKWB62A36PWSYKG7DZCQJJZ3OBOOYD6'
};

(async () => {
  const mustParams = {
    secret: createtor.secret,
    startingBalance: '100',
  }

  const optinalParams = {
    memo: Memo.text('Optional Params'),
    feeSource: feeSource.secret,
    feeMultiplication: 2,
    timeout: 30,
  }

  const res = await Account.create(
    mustParams.secret,
    mustParams.startingBalance,
  )(
    optinalParams,
  );
  console.log(res);
})();

/* response

{
  pubkey: 'GB4RN5TOY25BLJTFRU72WG6W65MGEDA6L3VYO5VCRD2B7ZZK76Y7BHQB',
  secret: 'SDMN5XZ55XO4ODOS37HKCKTMYA57OXT3YF777TATNCP5RCQ4JYOSCKW5'
}

*/

Account.getBalance()

Get balance(xlm, token) from target address. response is two types.


const {Account} = require('stellar-suite');

const pubkey = 'GCKFBEIYV2U22IO2BJ4KVJOIP7XPWQGQFKKWXR6DOSJBV7STMAQSMTGG';

(async() => {
  const res = await Account.getBalance(pubkey);
  console.log(res);
})();


/* response
{
  raw: '9999.9980200', 
  float: '9999.99802' 
}
*/

- Token -

Token.create()

create stellar token(official name asset)

const {Token} = require('stellar-suite');

const issuerPubkey = 'GCKFBEIYV2U22IO2BJ4KVJOIP7XPWQGQFKKWXR6DOSJBV7STMAQSMTGG';
const tokenName = 'TESTTOKEN';

const res = Token.create(tokenName, issuerPubkey);
console.log(res);


/* response
Asset {
  code: 'TESTTOKEN',
  issuer: 'GCKFBEIYV2U22IO2BJ4KVJOIP7XPWQGQFKKWXR6DOSJBV7STMAQSMTGG'
}
*/

Token.trustline()

trustline need to receive token by receiver


Token.trustline('must params')('optional params')

const {Token} = require('stellar-suite');

const issuerPubkey = 'GCKFBEIYV2U22IO2BJ4KVJOIP7XPWQGQFKKWXR6DOSJBV7STMAQSMTGG';
const receiverSecret = 'SAMTOLCOEJYAD5JUKP2XUVMGJ3QZ77E26T64PMGXDXLAYX5AQN7CFGTR';
const tokenName = 'TESTTOKEN';

(async() => {
  const token = Token.create(tokenName, issuerPubkey);
  const res = await Token.trustline(receiverSecret, token)();
  console.log(res.hash);
})();

/* response

c176fc1c71dd93c95fd49aef841410ed6eec3dc8937ea13202eb2241a919871c

*/

Payment

Payment.send()

send XLM or token


Payment.send('must params')('optional params')

send 1 XLM to receiver address

const {Payment} = require('stellar-suite');

const senderSecret = 'SCP5L3JUL4YP62BCUAXY3YXOIRLP3VYRXETANE53QSHKB6D2AMTY52K2';
const receiverPubkey = 'GBFXT3XP46G4PNMYM67IN5TC76ZVGBZVV2YTRP23D2IMBXAL2HAWGRO6';

(async () => {
  const amount = '1';
  const res = await Payment.send(
    receiverPubkey,
    senderSecret,
    amount,
  )();
  console.log(res.hash);
})();


/* response

b3da4cfb11cc918637f2fb4fc05ffda97b6b3cb13e1d44ca5531926d84d77e7e

*/

send 1 token(asset) to receiver address


const {
  Token,
  Payment
} = require('stellar-suite');

const issuer = {
  pubkey: 'GBKRTWUPAIABKFIK3FWZYOR2TXM5SHD4NUV225AAOFCV2HTWVEBUDUAC',
  secret: 'SCP5L3JUL4YP62BCUAXY3YXOIRLP3VYRXETANE53QSHKB6D2AMTY52K2'
};

const receiver = {
  pubkey: 'GA62CTAT6MCN5BPULVHCF5R44HO4V6M2JPXLGL55DRXNWS2TWVICOOC4',
  secret: 'SCQSPQESX2TFHOWJV4AF4FBFZVOC4X5JFR6VOJZ2L4K6YSW3XRVLTUAU'
};

(async () => {
  const token = Token.create('TEST', issuer.pubkey);
  await Token.trustline(receiver.secret, token)();
  const amount = '1';
  const res = await Payment.send(
    receiver.pubkey,
    issuer.secret,
    amount,
    token,
  )();
  console.log(res.hash);
})();


/* response

c37ee2b833350e4535085061934f797f3c5497a6156618c6f29ea68789fa7f1f

*/

- Multisig -

Multisig.set()

set multi signature


Multisig.set('must params')('optional params')

Set multiple signers in a target address


const {
  Multisig
} = require('stellar-suite');


const signer = {
  pubkey: 'GBKRTWUPAIABKFIK3FWZYOR2TXM5SHD4NUV225AAOFCV2HTWVEBUDUAC',
  secret: 'SCP5L3JUL4YP62BCUAXY3YXOIRLP3VYRXETANE53QSHKB6D2AMTY52K2'
};

const signer2 = {
  pubkey: 'GB4UYUVCYSAD73QHSPOK3HP3TFIJFE4VWCBMRFQSQDFXGAA4ZXPQYH4F',
  secret: 'SA67M7KTRTPMGWPHX34W3PA5LWTYJXNGFZUYPJS7MV5WZR5V5EAGURST'
};

const target = {
  pubkey: 'GA62CTAT6MCN5BPULVHCF5R44HO4V6M2JPXLGL55DRXNWS2TWVICOOC4',
  secret: 'SCQSPQESX2TFHOWJV4AF4FBFZVOC4X5JFR6VOJZ2L4K6YSW3XRVLTUAU'
};

(async () => {
  const res = await Multisig.set(
    target.secret,
    [
      {
        pubkey: signer.pubkey,
        weight: 1
      },
      {
        pubkey: signer2.pubkey,
        weight: 1
      },
    ],
    {
      masterWeight: 1,
      lowThreshold: 1,
      medThreshold: 2,
      highThreshold: 3
    }
  )();
  console.log(res.hash);
})();


/* resposne

cacb5986cfdab2b2d7beb3b279da7bdfc0ac43c174356868b49d8f92c211d45c

*/

- Memo -

Memo.text(), Memo.id(), Memo.hash(), Memo.return()


const {
  Memo
} = require('stellar-suite');

const res = Memo.text('0'.repeat(28));
console.log(res);

/* resposne

Memo { _type: 'text', _value: '0000000000000000000000000000' }

*/

Memo.Swarm.setText()

In stellar specific, MemoText is 28kbyte limit. this library internal use Ethereum Swarm, So stored over 28kbyte string.


const {
  Memo
} = require('stellar-suite');

const data = 'In a more restrained appearance, President Trump depicted Joseph R. Biden Jr. as an ineffectual Washington insider. Mr. Biden accused the president of heartlessness for separating migrant families and inflaming racial tensions. by New York Times(23/10/20)';
const res = await Memo.Swarm.setText(data);
console.log(res);

/* response
 
Memo {
  _type: 'hash',
  _value: <Buffer 43 1d eb 15 22 07 0a 1c dd 0e e4 8d 7f c2 15 3b 49 c5 4f 0a 36 31 c8 7
e 1f d6 72 6b de b6 d3 0a>
}

*/

Memo.Swarm.getText()

To Get stored data from swarm, Use encoded memo data in transaction and set in Memo.Swarm.setText('encoded data')


const {
  Memo
} = require('stellar-suite');

(async () => {
  const memoHash = 'Qs5GwukTIsifv+X23AaoRqDhK9VCSnzzsqPpae0Enns=';
  const res = await Memo.Swarm.getText(memoHash);
  console.log(res);
})();

/* response

Btesttesttesttesttesttesttesttesttesttesttesttesttesttesttesttesttesttesttest
testtesttesttesttesttesttesttesttesttesttesttesttesttesttesttesttesttesttesttesttesttest
testtesttesttesttesttesttesttesttesttesttesttesttesttesttesttesttesttesttesttesttesttest
testtesttesttesttesttesttesttesttesttesttesttesttesttesttesttesttesttesttesttesttesttest
testtesttesttesttesttesttesttesttesttesttesttesttesttesttest

*/

Transaction

Transaction.estimatedFee()

Can get estimate fee price

const {
  Transaction
} = require('stellar-suite');

(async () => {
  const res = await Transaction.estimatedFee();
  console.log(res);
})();

/* response

100

*/

Transaction.feeStats()

fee history information


const {
  Transaction
} = require('stellar-suite');

(async () => {
  const res = await Transaction.feeStats();
  console.log(res);
})();

/* response

{
  last_ledger: '77168',
  last_ledger_base_fee: '100',
  ledger_capacity_usage: '0',
  fee_charged: {
    max: '100',
    min: '100',
    mode: '100',
    p10: '100',
    p20: '100',
    p30: '100',
    p40: '100',
    p50: '100',
    p60: '100',
    p70: '100',
    p80: '100',
    p90: '100',
    p95: '100',
    p99: '100'
  },
  max_fee: {
    max: '100',
    min: '100',
    mode: '100',
    p10: '100',
    p20: '100',
    p30: '100',
    p40: '100',
    p50: '100',
    p60: '100',
    p70: '100',
    p80: '100',
    p90: '100',
    p95: '100',
    p99: '100'
  }
}
 
*/

Transaction.serverTimeout()

Can get unix timestamp + param value(second) in Horizon server

const {
  Transaction
} = require('stellar-suite');

(async () => {
  const res = await Transaction.serverTimeout(30);
  console.log(res);
})();

/* response

{ minTime: 0, maxTime: 1604283380 }  

*/

Transaction.get()

Get transaction datas. currently, only get account base

const {
  Transaction
} = require('stellar-suite');

const pubkey = 'GCKFBEIYV2U22IO2BJ4KVJOIP7XPWQGQFKKWXR6DOSJBV7STMAQSMTGG';

Transaction.get(pubkey, console.log);

/* response

{
  source: 'GCKFBEIYV2U22IO2BJ4KVJOIP7XPWQGQFKKWXR6DOSJBV7STMAQSMTGG',
  fee: '100',
  hash: '88a34344465b43abbc20ce3201df41a2129d88b94f3243179e3afad1f3ebcebc',
  createdAt: '2020-11-02T02:40:37Z',
  operations: [
    {
      source: 'GCKFBEIYV2U22IO2BJ4KVJOIP7XPWQGQFKKWXR6DOSJBV7STMAQSMTGG',
      type: 'payment',
      destination: 'GBP3XOFYC6TWUIRZAB7MB6MTUZBCREAYB4E7XKE3OWDP75VU5JB74ZF6',
      asset: [Asset],
      amount: '100000.0000000'
    }
  ],
  memo: { type: 'none', value: null },
  network: 'Test SDF Network ; September 2015',
  successful: true,
  feeSource: 'GCKFBEIYV2U22IO2BJ4KVJOIP7XPWQGQFKKWXR6DOSJBV7STMAQSMTGG'
}

*/

Transaction.stream()

Using stream protocol(server sent event),get transaction datas . currently, only get account base. runtime environment is HTML.


Transaction.stream('must params')('optional params')

|optional param |description | |----------|--------------------------| |cursor|payments happening starting position. default: 'now'| |order|ASC or DESC. default: 'ASC'| |limit|display limit count. default: '50', max: '200'|

<html>

<head>
  <script type="text/javascript" src="../dist/browser/stellar-suite.js">
  </script>
</head>

<body>
  <script>
      // Get transaction by stream data
      const pubkey = 'GAP5LETOV6YIE62YAM56STDANPRDO7ZFDBGSNHJQIYGGKSMOZAHOOS2S';
      const fn = StellarSuite.Transaction.stream(pubkey, console.log)();
  </script>
</body>

</html>

/* response

{
  source: 'GCKFBEIYV2U22IO2BJ4KVJOIP7XPWQGQFKKWXR6DOSJBV7STMAQSMTGG',
  fee: '100',
  hash: '88a34344465b43abbc20ce3201df41a2129d88b94f3243179e3afad1f3ebcebc',
  createdAt: '2020-11-02T02:40:37Z',
  operations: [
    {
      source: 'GCKFBEIYV2U22IO2BJ4KVJOIP7XPWQGQFKKWXR6DOSJBV7STMAQSMTGG',
      type: 'payment',
      destination: 'GBP3XOFYC6TWUIRZAB7MB6MTUZBCREAYB4E7XKE3OWDP75VU5JB74ZF6',
      asset: [Asset],
      amount: '100000.0000000'
    }
  ],
  memo: { type: 'none', value: null },
  network: 'Test SDF Network ; September 2015',
  successful: true,
  feeSource: 'GCKFBEIYV2U22IO2BJ4KVJOIP7XPWQGQFKKWXR6DOSJBV7STMAQSMTGG'
}

*/

Examples

look at source code: examples/
Usage Node.JS example

node examples/nodejs.js

Usage Browser example

chrome examples/browser.html

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

stellar-suite

How to install

The difference development(test) test and production enviroment

development

production

Usage

Node.js, ES6, Built in HTML

Modules description

- Account -

Account.create()()

Account.createTestnet()

development

production

Account.getBalance()

- Token -

Token.create()

Token.trustline()

Payment

Payment.send()

- Multisig -

Multisig.set()

- Memo -

Memo.text(), Memo.id(), Memo.hash(), Memo.return()

Memo.Swarm.setText()

Memo.Swarm.getText()

Transaction

Transaction.estimatedFee()

Transaction.feeStats()

Transaction.serverTimeout()

Transaction.get()

Transaction.stream()

Examples