Skip to content
This repository has been archived by the owner on Aug 21, 2024. It is now read-only.

Phase 1 updates to Soroban docs #747

Merged
merged 16 commits into from
Feb 27, 2024
Merged

Phase 1 updates to Soroban docs #747

Show file tree
Hide file tree
Changes from 11 commits
Commits
Show all changes
16 commits
Select commit Hold shift + click to select a range
e4a85db
Adding Mainnet to Networks section
briwylde08 Feb 26, 2024
7bc4bf1
Add Mainnet information to Block Explorers
briwylde08 Feb 26, 2024
df5edb9
Add Releases section for Phase 1
briwylde08 Feb 26, 2024
adc38c9
put in version numbers for (most) software
ElliotFriend Feb 26, 2024
f87df5d
add changelong for soroban rpc
ElliotFriend Feb 26, 2024
629022d
add changelog for soroban cli
ElliotFriend Feb 26, 2024
386708d
add mainnet passphrase to protocol 20 release notes
ElliotFriend Feb 26, 2024
865608b
try another title for this version
ElliotFriend Feb 26, 2024
f8c332b
remove unnecessary headings
ElliotFriend Feb 26, 2024
52bfcb6
update Horizon link for Mainnet
briwylde08 Feb 26, 2024
8e6ee43
Merge branch 'phase-1-updates' of https://github.com/stellar/soroban-…
briwylde08 Feb 26, 2024
fab63f7
add resource limits and fees to releases page
ElliotFriend Feb 27, 2024
73dda53
shifting some things around in resource limits for phase 1
ElliotFriend Feb 27, 2024
53e3209
use `TBD` for soroban react version placeholders
ElliotFriend Feb 27, 2024
84e2eb0
networks placeholders
briwylde08 Feb 27, 2024
c2e39ce
add validator and history urls for Mainnet
ElliotFriend Feb 27, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 7 additions & 7 deletions docs/reference/data-providers.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,11 +18,11 @@ To power your applications, a range of data services will be available from data

## Block Explorers

Block explorers exist to publicly display blockchain data in an easily digestbible way. They can be browsed with an ordinary web browser, and do not require any special developer skills to use. The block explorers available for Soroban index data related to payments, accounts, deployed contracts, transaction history, and more. The following block explorers are available for the Testnet and Futurenet (Mainnet coming with launch).
Block explorers exist to publicly display blockchain data in an easily digestbible way. They can be browsed with an ordinary web browser, and do not require any special developer skills to use. The block explorers available for Soroban index data related to payments, accounts, deployed contracts, transaction history, and more. The following block explorers are available for Mainnet, Testnet, and Futurenet.

| Provider | Testnet | Futurenet |
| :----------------------------------------------- | ----------------------------------------------------------- | -------------------------------------------------------- |
| [StellarExpert](https://stellar.expert) | [Testnet Explorer](https://stellar.expert/explorer/testnet) | n/a |
| [StellarChain](https://stellarchain.io/) | [Testnet Explorer](https://testnet.stellarchain.io/) | [Futurenet Explorer](https://futurenet.stellarchain.io/) |
| [Soroban Scan](https://soroban.nownodes.io/info) | [Testnet Explorer](https://soroban.nownodes.io/testnet) | [Futurenet Explorer](https://soroban.nownodes.io/) |
| [StellarExplorer](https://steexp.com/) | [Testnet Explorer](https://testnet.steexp.com/) | [Futurenet Explorer](https://futurenet.steexp.com/) |
| Provider | Mainnet | Testnet | Futurenet |
| :----------------------------------------------- | ---------------------------------------------------------- | ----------------------------------------------------------- | -------------------------------------------------------- |
| [StellarExpert](https://stellar.expert) | [Mainnet Explorer](https://stellar.expert/explorer/public) | [Testnet Explorer](https://stellar.expert/explorer/testnet) | N/A |
| [StellarChain](https://stellarchain.io/) | [Mainnet Explorer](https://stellarchain.io/) | [Testnet Explorer](https://testnet.stellarchain.io/) | [Futurenet Explorer](https://futurenet.stellarchain.io/) |
| [Soroban Scan](https://soroban.nownodes.io/info) | N/A | [Testnet Explorer](https://soroban.nownodes.io/testnet) | [Futurenet Explorer](https://soroban.nownodes.io/) |
| [StellarExplorer](https://steexp.com/) | [Mainnet Explorer](https://steexp.com/) | [Testnet Explorer](https://testnet.steexp.com/) | [Futurenet Explorer](https://futurenet.steexp.com/) |
18 changes: 9 additions & 9 deletions docs/reference/networks.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,19 +4,19 @@ title: Networks
description: The shared Soroban test networks.
---

Testnet and Futurenet have been made available as the first shared test networks to enable developers to learn, tinker, and build applications on Soroban while being able to interact with other participants.
Read more about the different networks in the [Networks section](https://developers.stellar.org/docs/fundamentals-and-concepts/networks) in the Stellar docs.

| Testnet | Testnet | Futurenet |
| :----------------- | ----------------------------------- | ---------------------------------------- |
| Network Passphrase | `Test SDF Network ; September 2015` | `Test SDF Future Network ; October 2022` |
| Horizon API | https://horizon-testnet.stellar.org | https://horizon-futurenet.stellar.org |
| Friendbot API | https://friendbot.stellar.org | https://friendbot-futurenet.stellar.org |
| Validator | `core-live-testnet.stellar.org` | `core-live-futurenet.stellar.org` |
| History Archive | https://history-testnet.stellar.org | https://history-futurenet.stellar.org |
| | Mainnet | Testnet | Futurenet |
| :----------------- | ------------------------------------------------ | ----------------------------------- | ---------------------------------------- |
| Network Passphrase | `Public Global Stellar Network ; September 2015` | `Test SDF Network ; September 2015` | `Test SDF Future Network ; October 2022` |
| Horizon API | https://horizon.stellar.org/ | https://horizon-testnet.stellar.org | https://horizon-futurenet.stellar.org |
| Friendbot API | N/A | https://friendbot.stellar.org | https://friendbot-futurenet.stellar.org |
| Validator | **help** | `core-live-testnet.stellar.org` | `core-live-futurenet.stellar.org` |
| History Archive | **help** | https://history-testnet.stellar.org | https://history-futurenet.stellar.org |

:::caution

Testnet can be reset at any time. A reset erases all accounts, contract data, and contract deployments from the network.
Testnet and Futurenet can be reset at any time. A reset erases all accounts, contract data, and contract deployments from the network.

:::

Expand Down
181 changes: 122 additions & 59 deletions docs/releases.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,68 @@ Release candidates are software releases that are also released to the [Testnet]

[Testnet]: reference/networks.mdx

## Protocol 20: Soroban Phase 1 (February 27, 2024)

### Software

| Software | Version |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| XDR | [8b9d623ef40423a8462442b86997155f2c04d3a1](https://github.com/stellar/rs-stellar-xdr/commit/8b9d623ef40423a8462442b86997155f2c04d3a1) |
| Soroban Environment | `v20.2.2` |
| Soroban Interface Version | `0` |
| Stellar Core | `v20.2.0` |
| Soroban Rust SDK | `v20.3.2` |
| Soroban CLI | `v20.3.1` |
| Soroban RPC | `v20.3.3` |
| Stellar Horizon | `v2.28.3` |
| Stellar Friendbot | `TBD` |
| Stellar Quickstart | `docker.io/stellar/quickstart:latest@sha256:1a82b17a4fae853d24189dd25d4e6b774fa7a1b6356a993e618c6e9bd2f3e04c` |
| Stellar JS Stellar Base | [`v11.0.0`](https://github.com/stellar/js-stellar-base/releases/tag/v11.0.0) |
| Stellar JS Stellar SDK | [`v11.2.2`](https://github.com/stellar/js-stellar-sdk/releases/tag/v11.2.2) |
| Freighter | `v5.17.0` |
| Laboratory | `v4.1.0` |
| Soroban React Payment dapp | **help** |
Copy link
Contributor

@Julian-dev28 Julian-dev28 Feb 27, 2024 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@piyalbasu @aristidesstaffieri

Are you able to provide the Protocol 20 compatible versions for the Soroban React series here?

| Soroban Mint Token dapp | **help** |
| Soroban Swap Token dapp | **help** |
| Futurenet Network Passphrase | `Test SDF Future Network ; October 2022` |
| Testnet Network Passphrase | `Test SDF Network ; September 2015` |
| Mainnet Network Passphrase | `Public Global Stellar Network ; September 2015` |

### Changelog

#### Soroban RPC

- (tag: v20.3.3) Bump version to 20.3.3
- Update Dockerfile and Makefile to refer rpc instead of tools
- Fix publish-dry-run failures
- Revert "soroban-rpc: Remove publish-dry-run Workflow"
- Perform fee padding in a larger bit width of integers
- (tag: v20.3.2) Bump version to 20.3.2
- Merge pull request #68 from stellar/add-spec-tools-crate
- Merge branch 'main' into add-spec-tools-crate
- Change module from soroban-tool to rpc in go.mod
- Add hardcoded WASM file and reference it in tests
- Uncomment install_rust
- Add prometheus hook to count different log levels
- Remove build-test-wasms from makefile

#### Soroban CLI

- (tag: v20.3.1) Bump version to 20.3.1
- Update references in end-to-end tests to point to the latest releases
- Bump version of soroban rpc and spec tools
- Repoint soroban-spec-tools to the moved one in stellar/soroban-rpc
- Rename Cargo.toml in the init template files
- soroban-cli: Remove ALL RPC Related Code and Workflows
- Use soroban-rpc crate from the RPC repo
- fix: embed the init template files in the build
- [Epic] Separating soroban-rpc to prepare for repo change
- Soroban contract init followup
- Merge pull request #1190 from stellar/release/v20.3.0
- Merge branch 'main' into release/v20.3.0
- Revert "[Epic] Separating soroban-rpc to prepare for repo change"
- [Epic] Separating soroban-rpc to prepare for repo change

## Protocol 20 (February 5, 2024): Mainnet Edition (Phase 0)

### Software
Expand All @@ -39,82 +101,83 @@ Release candidates are software releases that are also released to the [Testnet]
| Soroban Swap Token dapp | `TBD` |
| Futurenet Network Passphrase | `Test SDF Future Network ; October 2022` |
| Testnet Network Passphrase | `Test SDF Network ; September 2015` |
| Mainnet Network Passphrase | `Public Global Stellar Network ; September 2015` |

### Changelog

#### XDR

Run CI for the msrv and latest rust version
Backfill changes to next for json rendering
Bump XDR
Bump version to 20.1.0
- Run CI for the msrv and latest rust version
- Backfill changes to next for json rendering
- Bump XDR
- Bump version to 20.1.0

#### Soroban Environment

Allow small version-range wiggle room on curve25519-dalek to enable docs.rs nightly build
Bump version to 20.2.2
Enable publish of soroban-simulation crate
Add a function to invoke host function 'end-to-end' in recording mode.
Bug 1283 asset code rendering
Use strkeys for contract IDs and addresses in diagnostic events.
Turn off wasm_reference_types in Wasmi
Prng tests
Remove ConversionError from ScVal/Val conversions
Tightening up metering in auth
Bump XDR to 20.1
Allow negative fee1 kb low
Bump version to 20.2.0
Cover various Symbol conversion code paths with various valid/invalid cases
Run CI for the msrv and latest rust version
Add protocol version method to invoke_contract
Enable VM execution in a WASM environment by guarding time track behind time feature
Add test for checking VM stack depth.
Migrate preflight computations from soroban-rpc
soroban-simulate: Misc fixes
Add CI job to run cargo-semver-checks
Tracing
Add some basic test coverage for e2e_invoke.
Add test vectors for ed25519 edge cases
Trace should not emit diagnostic errors
Bump wasmi to 0.31.1-soroban.20.0.1
Bump version to 20.1.1
- Allow small version-range wiggle room on curve25519-dalek to enable docs.rs nightly build
- Bump version to 20.2.2
- Enable publish of soroban-simulation crate
- Add a function to invoke host function 'end-to-end' in recording mode.
- Bug 1283 asset code rendering
- Use strkeys for contract IDs and addresses in diagnostic events.
- Turn off wasm_reference_types in Wasmi
- Prng tests
- Remove ConversionError from ScVal/Val conversions
- Tightening up metering in auth
- Bump XDR to 20.1
- Allow negative fee1 kb low
- Bump version to 20.2.0
- Cover various Symbol conversion code paths with various valid/invalid cases
- Run CI for the msrv and latest rust version
- Add protocol version method to invoke_contract
- Enable VM execution in a WASM environment by guarding time track behind time feature
- Add test for checking VM stack depth.
- Migrate preflight computations from soroban-rpc
- soroban-simulate: Misc fixes
- Add CI job to run cargo-semver-checks
- Tracing
- Add some basic test coverage for e2e_invoke.
- Add test vectors for ed25519 edge cases
- Trace should not emit diagnostic errors
- Bump wasmi to 0.31.1-soroban.20.0.1
- Bump version to 20.1.1

#### Soroban Rust SDK

Update soroban-env-\*
Bump version to 20.3.2
Update extend_ttl docs
Bug 1076 conversion error flattening
- Update soroban-env-\*
- Bump version to 20.3.2
- Update extend_ttl docs
- Bug 1076 conversion error flattening

#### Soroban RPC

Migrate Soroban Tools to Soroban RPC
Use soroban-tools Crates
Pull in Recent Soroban RPC changes from soroban-tools
Mirror Last Remaining PRs from soroban-tools Repo
Add Workflow to Publish soroban-rpc Crate
added user agent config on ha archive pool
Update getTxn rpc with events data
Remove publish-dry-run Workflow
Use external soroban-simulation library for preflight computations
Store and serve the event transaction ID
Reduce event memory footprint
Add diagnostic events to sendTransaction response
Remove panics from internal codebase
- Migrate Soroban Tools to Soroban RPC
- Use soroban-tools Crates
- Pull in Recent Soroban RPC changes from soroban-tools
- Mirror Last Remaining PRs from soroban-tools Repo
- Add Workflow to Publish soroban-rpc Crate
- added user agent config on ha archive pool
- Update getTxn rpc with events data
- Remove publish-dry-run Workflow
- Use external soroban-simulation library for preflight computations
- Store and serve the event transaction ID
- Reduce event memory footprint
- Add diagnostic events to sendTransaction response
- Remove panics from internal codebase

#### Soroban CLI

feat: soroban init command
Bump dependencies for pubnet release
Upgrade Ubuntu to 22.04 from 20.04
Bump Go, Rust and Core dependencies
feat/cli: Move config commands to top level
bindings-ts: update to latest SDK & TypeScript, add CI test
TypeScript bindings have been updated to use the latest stellar-sdk
Support multi-auth workflows in typescript bindings
Replace cli xdr command with stellar-xdr cli
Update typescript bindings for latest versions
Warn about RC versions only when using pubnet
- feat: soroban init command
- Bump dependencies for pubnet release
- Upgrade Ubuntu to 22.04 from 20.04
- Bump Go, Rust and Core dependencies
- feat/cli: Move config commands to top level
- bindings-ts: update to latest SDK & TypeScript, add CI test
- TypeScript bindings have been updated to use the latest stellar-sdk
- Support multi-auth workflows in typescript bindings
- Replace cli xdr command with stellar-xdr cli
- Update typescript bindings for latest versions
- Warn about RC versions only when using pubnet

## Stable v20.1.0 (January 11, 2024)

Expand Down
Loading