Lesson 8 of 11 · Power tools · about 6 minutes

Shared keys, votes and loans

Accounts that need two keys, how the ledger votes on upgrades, and what on-ledger lending is.

  • Multi-sign
  • Voting on upgrades
  • Lending
Astro Bear with three keys for one vault.
1 · Shared keys

Two of three must agree

Multi-sign means an account needs more than one key to act. Like a family account where 2 of 3 parents must approve.

If one key is lost or stolen, the money is still safe.

Three signers each hold a key. Two keys slide into the vault and then it opens.2 of 3XTwo keys must agree before the vault opens
Two of three keys must agree before the vault opens.
2 · Weights

Some keys count more

Each signer can have a weight. The account sets a total, called the quorum, that the signatures must reach.

For example, a boss key could count 2, and two staff keys 1 each.

Signers have different weights. Their weights add up on a meter until it reaches the quorum line.weight 2weight 1weight 1quorum 3Bear A (2) + onemore (1) = 3Weights add up. Reach the quorum to approve.
Weights add up until they reach the quorum.
3 · Voting

How the rules change

New features are called amendments. Validators vote on them. An amendment turns on only after more than 80% support it for two weeks straight.

No single company can flip the switch.

Validators vote, a bar fills to the 80 percent line and holds for two weeks, then the amendment switch flips on.validators vote80% for 2 weeksEnabledEnough votes, held long enough, then the rule turns on
Validators vote. With enough support held long enough, a rule turns on.
4 · Loans

Lending on the ledger

The XRP Ledger has a lending design: pooled vaults that lend to borrowers, who pay interest back. Think of a shared pot, like a pool, but for loans.

Big features like this only go live after the vote above. Use the live check below to see if it is on.

Idea only, not live yet: a vault lends coins to a borrower, the borrower pledges collateral, and pays interest back.Vaultpooled coinsBorrowerXLoanpledgeCollateral+Interest comes back with the loanNOT LIVE YETStill being voted on. This shows the idea only.
The idea: a vault lends, collateral is pledged, interest comes back. Not live yet.

Try it: 2 of 3 keys

Set up an account that needs 2 of 3 signers, watch one signature fail, then pay with two. Free test coins, no real money. It makes throwaway test wallets in this page and never shows or asks for a secret.

Check it live: is lending switched on?

New features turn on only after a vote. Ask the test network right now which ones are on.

Mini game: Enough keys?

Eight cards. Do the signatures add up to the quorum of 2?

Quick check: 3 questions

Get all 3 right to finish Lesson 8. Try as many times as you like.

Optional: the 4-panel comic for this lesson

Who is who: ☉︎ Sol, the Sun☽︎ Luna, the Moon♁︎ Gaia, the Earth

1
I lost one of our three keys!
2
Relax. Our vault needs 2 of 3.
3
We two sign, and swap in a new key.
4
Safe and sound. Teamwork!

Just for fun. You do not need it to finish. Download the comic