feat: add (local|testnet|mainnet) default networks

[chadoh]

Similar to how we support --network futurenet before you even set it.

No need to make people go look it up on https://developers.stellar.org/docs/reference/networks

This adds a dependency on phf to construct a compile-time Map of named networks to named network settings.

It also lists default networks with the network ls [-l] commands, and slightly updates (fixes, really) the behavior of network ls. Previously, if you had a local and global network named the same thing, network ls would show that name twice. Now it will only show them once. When you network ls -l, it will show all name collisions.

$ stellar network ls
future
futurenet
local
testnet
mainnet


$ stellar network ls -l
Local "/Users/chadoh/code/s/cli/.soroban/network/future.toml"
Name: future
Network {
    rpc_url: "https://rpc-futurenet.stellar.org:443",
    network_passphrase: "Test SDF Future Network ; October 2022",
}

Local "/Users/chadoh/code/s/cli/.soroban/network/futurenet.toml"
Name: futurenet
Network {
    rpc_url: "https://rpc-futurenet.stellar.org:443",
    network_passphrase: "Test SDF Future Network ; October 2022",
}

Global "/Users/chadoh/.config/soroban/network/future.toml"
Name: future
Network {
    rpc_url: "https://rpc-futurenet.stellar.org:443",
    network_passphrase: "Test SDF Future Network ; October 2022",
}

Global "/Users/chadoh/.config/soroban/network/local.toml"
Name: local
Network {
    rpc_url: "http://localhost:8000/rpc",
    network_passphrase: "Standalone Network ; February 2017",
}

Global "/Users/chadoh/.config/soroban/network/testnet.toml"
Name: testnet
Network {
    rpc_url: "https://soroban-testnet.stellar.org",
    network_passphrase: "Test SDF Network ; September 2015",
}

Default
Name: local
Network {
    rpc_url: "http://localhost:8000/rpc",
    network_passphrase: "Standalone Network ; February 2017",
}

Default
Name: futurenet
Network {
    rpc_url: "https://soroban-testnet.stellar.org",
    network_passphrase: "Test SDF Network ; September 2015",
}

Default
Name: mainnet
Network {
    rpc_url: "Bring Your Own: https://developers.stellar.org/docs/data/rpc/rpc-providers",
    network_passphrase: "Public Global Stellar Network ; September 2015",
}

Default
Name: testnet
Network {
    rpc_url: "https://rpc-futurenet.stellar.org:443",
    network_passphrase: "Test SDF Future Network ; October 2022",
}

[willemneal]

Looks good to me. One thing to check and it might have been filled as an issue in the past, but do the default networks show up when using network ls? Should they?

[janewang]

Amazing and finally. For mainnet, could we also set the network passphrase please 🙏

[chadoh]

do the default networks show up when using network ls?

They do not.

Should they?

Good question! @janewang?

---

@willemneal did you see the "Known Limitations" section? Are these tests being run? Which CI job runs them?

[janewang]

Should they?

Yes, don't me think.

[chadoh]

For mainnet, could we also set the network passphrase please

@willemneal is there a straightforward way to do this? We currently require a Network to have both rpc_url and network_passphrase both set. Maybe we make a default that looks something like this?

Network {
    rpc_url: "https://example.com/bring-your-own-rpc".to_owned(), 
    network_passphrase: "Public Global Stellar Network ; September 2015".to_owned(),
},

[janewang]

For rpc_url, we have a page on the dev docs that lists all available mainnet rpc in the ecosystem. This page is likely a good place to send someone who needs a mainnet rpc url: https://developers.stellar.org/docs/data/rpc/rpc-providers

[chadoh]

Great idea, @janewang! I've updated the PR description to show the full output of network ls and network ls -l; here's what mainnet looks like with the long listing:

Default
Name: mainnet
Network {
    rpc_url: "Bring Your Own: https://developers.stellar.org/docs/data/rpc/rpc-providers",
    network_passphrase: "Public Global Stellar Network ; September 2015",
}`

[willemneal]

As I have been saying for sometime the config needs some refactoring but this looks good to me!