Skip to content

Conversation

@apoelstra
Copy link
Collaborator

With suggestions and rewording from Claude 4.

The next PR will attempt to fill in the top-level library docs which appear on docs.rs, including more useful simple example programs.

@apoelstra
Copy link
Collaborator Author

cc @imaginator @roconnor-blockstream

Also cc @sanket1729 @uncomputable in case you have opinions and are willing to take the time to review this.

@apoelstra apoelstra force-pushed the 2025-08/readme branch 4 times, most recently from 0d89271 to 30716ca Compare August 10, 2025 23:40
Copy link
Collaborator Author

@apoelstra apoelstra left a comment

Choose a reason for hiding this comment

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

On 30716ca successfully ran local tests

sanket1729
sanket1729 previously approved these changes Aug 11, 2025
Copy link
Member

@sanket1729 sanket1729 left a comment

Choose a reason for hiding this comment

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

Looks good

README.md Outdated
This is the official Rust library of the [Simplicity Language](https://simplicity-lang.org/).

The MSRV of this crate is **1.78.0**.
Simplicity is a low-level, typeed functional language designed to be a drop-in replacement
Copy link
Contributor

Choose a reason for hiding this comment

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

Not replacement but more like alternative.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Sure, I think "drop-in alternative" reads ok. I agree that "replacement" is too agressive a term.

README.md Outdated
- cross-validating the C and Rust Bit Machine implementations

The libsimplicity repository also contains:
- A Haskell library with similar goals to rust-simplicity
Copy link
Contributor

Choose a reason for hiding this comment

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

While this is not wrong, I think it is better to have folks think of the Haskell library as a reference implementation instead. Indeed we generate some Rust code from this reference.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Sure, updated.

Copy link
Contributor

@roconnor-blockstream roconnor-blockstream left a comment

Choose a reason for hiding this comment

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

LGTM

README.md Outdated
This is the official Rust library of the [Simplicity Language](https://simplicity-lang.org/).

The MSRV of this crate is **1.78.0**.
Simplicity is a low-level, typeed functional language designed to be a drop-in alternative
Copy link
Collaborator

Choose a reason for hiding this comment

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

s/typeed/typed

@canndrew
Copy link
Collaborator

LGTM, other than that one typo.

With suggestions and rewording from Claude 4.
@apoelstra
Copy link
Collaborator Author

Gonna go ahead and merge this.

@apoelstra apoelstra merged commit 6934a57 into BlockstreamResearch:master Aug 12, 2025
24 checks passed
@apoelstra apoelstra deleted the 2025-08/readme branch August 12, 2025 20:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants