Starlight is a demo implementation of payment channels on Stellar.
Payment channels allow parties to transact privately, instantly, and securely, while paying zero fees. They are also a first step toward constructing and connecting to payment channel networks like Lightning and Interledger.
This release includes the Starlight wallet, a user interface that lets you create bilateral payment channels and use them to transact in lumens (the native asset of the Stellar protocol) on the Stellar testnet.
If you encounter any bugs, want to request a feature, or have any questions about the software, you can open an issue or pull request on GitHub, or talk to us in the #starlight channel on the Interstellar Slack.
Please note that this software is still in development and will likely contain multiple security and functional bugs and issues. This code is for testing only on the Stellar testnet. It is not compatible with the Stellar mainnet. Attempting to modify it for use on the Stellar mainnet may result in permanent XLM loss. Any use of this software is strictly at your own risk, and we will not be liable for any losses or damages.
You can download the appropriate archive for your platform from the releases page.
Then, extract it somewhere on your executable path, for example:
$ tar -C /usr/local/bin -xzf starlightd-darwin-amd64.tar.gz
which starlightd should then output wherever you've just extracted the executable to.
Alternatively, instructions for installing from source are below.
You can run a Starlight instance using the
This will set up a data directory, called
starlight-data, in your current directory.
You can then open the wallet by going to http://localhost:7000 in your browser.
If, at any time, you want to reset your agent completely, you can clear your data directory:
$ rm -rf starlight-data
Running a second instance on the same computer
To try out
starlightd for the first time,
you'll want to run two instances on the same computer and create a payment channel between them,
as described in the tutorial.
You can run a second instance on your computer by listening on a different port,
and using a separate data directory.
$ starlightd --listen=localhost:7001 --data=starlight-data-2
To log in to this wallet, open an incognito or private window, to prevent this session from logging out your other session, and go to http://localhost:7001.
Connecting to instances on other computers
If you are running your Starlight instance on your personal computer and want to connect it with instances on other computers or servers, you'll need to give your instance a publicly-accessible URL. One way to do so is by using a service like Serveo or ngrok. For example, you can run the following command:
$ ssh -R 80:localhost:7000 serveo.net
Your Starlight address will then be served on a subdomain of serveo.net (so your Stellar address will be something like alice*something.serveo.net).
Running an instance on AWS
Alternatively, you can run your Starlight instance on a cloud computing platform like Amazon Web Services or DigitalOcean. This more closely resembles how future production versions of Starlight would likely be hosted.
You can find instructions for setting up a Starlight instance on AWS here.
Start by installing
starlightd, setting up two instances locally, and opening two browser windows to http://localhost:7000 and http://localhost:7001 (exactly one of which must be in a private or incognito window, to prevent the sessions from interfering with each other).
Configure each wallet, picking "alice" and "bob" as the respective usernames.
Starlight provides a simple lumen wallet, which manages an account that is funded with 10,000 testnet lumens upon setup.
The wallet gives you a Stellar address, e.g., "alice*localhost:7000".
You can use this wallet to make on-network payments to users' Stellar addresses (i.e., alice*stellar.org) or their Stellar account IDs (e.g., GAIH3ULLFQ4DGSECF2AR555KZ4KNDGEKN4AFI4SU2M7B43MGK3QJZNSR).
Try having Alice send a 100 XLM payment to Bob.
The core feature of Starlight is payment channels. Payment channels allow two parties to make payments to each other using free, private, and secure off-network transactions.
Try having Alice create a 500 XLM payment channel with Bob (bob*localhost:7001).
The channel will take a few seconds to open. Once the channel is open, try having Alice send 100 XLM to Bob, then try having Bob send 50 XLM back to Alice. Note that since these payments happened in the payment channel rather than on the public network, they were almost instant, and the parties paid no fee.
Examine the Capacity graph, which shows how much each party can currently send and receive in the channel. The total capacity of the channel is limited to the amount that has been deposited in it. While the parties can make payments back and forth as long as they like, no party can make a payment that would exceed the channel's capacity.
The party that created the channel can deposit additional funds into the channel. This moves funds from their wallet account to their balance in the channel, and increases the total capacity of the channel. Try having Alice deposit 500 XLM into the channel, by clicking Deposit on the channel page.
Closing a channel
The funds that are locked in this channel can be paid back and forth between Alice and Bob instantly. However, if Alice or Bob want to make payments to anyone else, or use those lumens in any other channel, they will need to withdraw the funds by closing the channel.
Try having Bob close the channel by clicking Close on the channel page. After a few seconds, the channel should close, and the parties' funds should be withdrawn to their wallet accounts.
This worked because Bob's instance was online, and it automatically cooperated with the channel close request. If Bob's instance was offline or did not cooperate, Alice would need to "force close" the channel, which would mean that there would be some delay before she would receive her funds.
Build starlightd from source
starlightd from its GitHub repository.
$ go get github.com/interstellar/starlight/...
You can now run the command
starlightd from anywhere. This will create a data directory called
starlight-data in your current directory, and will run a wallet, which you can access at http://localhost:7000.
Build wallet from source
When running the
starlightd binary, it automatically downloads and serves the latest version of the front-end wallet.
If you want to make changes to the wallet source code, you can rebuild and run it independently:
$ cd $GOPATH/github.com/interstellar/starlight/starlight/wallet $ npm install $ npm start
The wallet should now be running at port 5000:
$ open http://localhost:5000
To run a second development wallet on port 5001, connecting to a
starlightd running on port 7001:
$ PORT=5001 STARLIGHTD_URL=http://localhost:7001 npm start
The Starlight project has unit tests and integration tests for the starlight server and the wallet frontend.
To run the Starlight server unit tests:
$ cd $I10R/starlight $ go test -short ./...
To run the Starlight wallet unit tests:
$ cd $I10R/starlight/wallet $ ./bin/tests
To run the Starlight integration tests:
$ cd $I10R/starlight/starlighttest $ go test
To run the integration tests with a custom Horizon URL:
$ go test -args -horizon="http://custom-horizon-testnet.com"
Starlight is under active development at Interstellar. Our top priorities for the coming year include:
- Stabilization and final specification of protocol and API
- Channels for non-native assets
- Cross-channel atomic payments
- Cross-currency atomic payments
- Compatibility with Interledger and Lightning
- Peer-to-peer connectivity
- Stellar mainnet launch
To learn more about these projects, or to let us know what features you would most like to see, you can join the discussion in the #starlight channel on the Interstellar Slack.