Skip to content

chatch/stellarexplorer

Repository files navigation

Stellar Explorer

Node.js CI Run e2e tests against production

A ledger explorer for Stellar.

Deployments:

Resources

Lists

Resource URI
Operations /operations
Transactions /txs
Ledgers /ledgers
Payments /payments
Trades /trades
Effects /effects
Liquidity Pools /effects
Claimable Balances /effects

Directory

Resource URI
Assets /assets
Anchors /anchors
Exchanges /exchanges

Accounts

Resource URI
by Federated address /account/stellar*fed.network
by Public address /account/GAREELUB43IRHWEASCFBLKHURCGMHE5IF6XSE7EXDLACYHGRHM43RFOX
by Multiplexed address /account/MDZ464OWNGEL4X2DE6JPLEARO2WJ4AGCBN3XM7E4ZSLPHRBV6AZB6AAAAAAAAAAAAGW4M

Tabs

Resource URI
Balances Tab /account/stellar*fed.network#balances
Payments Tab /account/stellar*fed.network#payments
Offers Tab /account/stellar*fed.network#offers
Trades Tab /account/stellar*fed.network#trades
Effects Tab /account/stellar*fed.network#effects
Operations Tab /account/stellar*fed.network#operations
Transactions Tab /account/stellar*fed.network#transactions
Signing Tab /account/stellar*fed.network#signing
Flags Tab /account/stellar*fed.network#flags
Data Tab /account/stellar*fed.network#data

Search

Resource URI
Federated address /search/steexp*fed.network
Public address /search/GAREELUB43IRHWEASCFBLKHURCGMHE5IF6XSE7EXDLACYHGRHM43RFOX
Multiplexed address /search/MDZ464OWNGEL4X2DE6JPLEARO2WJ4AGCBN3XM7E4ZSLPHRBV6AZB6AAAAAAAAAAAAGW4M
Ledger /search/10000000
Transaction /search/26a568681712a44a515b2c90dcfaadb3ed2c40dc60254638407937bee4767071
Asset Code /search/NGN
Anchor Name /search/ripplefox
Anchor Name (Partial) /search/fox

Misc

Resource URI
Transaction /tx/26a568681712a44a515b2c90dcfaadb3ed2c40dc60254638407937bee4767071
Ledger /ledger/10000000
Anchor /anchor/apay.io
Asset /asset/NGN

Exploring Private / Local Development Networks

steexp will connect to a local horizon instance at http://localhost:8000 by default. If your running a local private network for development this is quite handy for browsing your changes to the ledger.

Alternatively you can run locally connecting to the testnet or public network horizon instances. To do this define these aliases to localhost:

127.0.1.1  testnet.local     # for steexp use testnet horizon
127.0.1.1  publicnet.local   # for steexp use mainnet horizon
127.0.1.1  futurenet.local   # for steexp use future horizon

Use 127.0.0.1 instead of 127.0.1.1 when the above doesn't work.

Navigate to http://testnet.local:3000, http://futurenet.local:3000 or http://publicnet.local:3000 to select the network your interesting in exploring.

Development

See the section Exploring Private / Local Development Networks for connecting to different backend networks. By default steexp will look for a local instance of horizon.

Start

npm i && npm run dev

Test

npm i && npm test

or

You can run test with Jest Preview with the following command. You can see the result at http://locahost:3336 for test using React Testing Library along with Jest Preview.

npm run test:preview

or

You can run test and Jest Preview separately as follows (this is basically same as the previous one).

npm run jest-preview

npm test
or
npm run test:watch

E2E Test

npm run test:e2e

Run the test in UI mode:

npm run test:e2e:ui

Show HTML test reports:

npm run test:e2e:report

Build

npm i && npm run build

Languages

Use the language selector in the top right corner to change the language.

Translation files are here: https://github.com/chatch/stellarexplorer/tree/master/src/languages

Submit pull requests with new languages or languages fixes there.

Scripts

Fetch and restructure centralized exchanges data

npx ts-node scripts/restructure-centralized-exchanges-json.ts