Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update Orch/Unbond Walkthrough #1221

Merged
merged 2 commits into from
Oct 7, 2024
Merged

Update Orch/Unbond Walkthrough #1221

merged 2 commits into from
Oct 7, 2024

Conversation

amessbee
Copy link
Contributor

@amessbee amessbee commented Oct 1, 2024

unbond example contract in orchestration has changed since we lasted documented it here. This is an update based on the new changes.

Refs:

@amessbee amessbee force-pushed the ms/update-unbond-walkthrough branch from 71fdec0 to aebbc20 Compare October 1, 2024 11:36
Copy link

cloudflare-workers-and-pages bot commented Oct 1, 2024

Deploying documentation with  Cloudflare Pages  Cloudflare Pages

Latest commit: 1a2fc75
Status: ✅  Deploy successful!
Preview URL: https://85705e74.documentation-7tp.pages.dev
Branch Preview URL: https://ms-update-unbond-walkthrough.documentation-7tp.pages.dev

View logs

@amessbee amessbee changed the title Update Orch/Unbond Walkthrough --WIP-- Update Orch/Unbond Walkthrough Oct 1, 2024
@amessbee amessbee requested review from mujahidkay and Jovonni October 1, 2024 13:31
@amessbee amessbee self-assigned this Oct 1, 2024
Copy link
Member

@mujahidkay mujahidkay left a comment

Choose a reason for hiding this comment

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

Added a few comments. Rest looks good and easy to follow :)


- `M`: Imported from @endo/patterns, provides pattern-matching utilities.
- `withOrchestration`: Imported from a utility module, used to set up and provide access to orchestration tools.
The Unbond Contract leverages the Agoric orchestration to interact with external chains, like Osmosis and Stride, to facilitate unbonding and transferring assets from one chain to another.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
The Unbond Contract leverages the Agoric orchestration to interact with external chains, like Osmosis and Stride, to facilitate unbonding and transferring assets from one chain to another.
The Unbond Contract leverages the Agoric orchestration API to interact with external chains, like Osmosis and Stride, to facilitate unbonding and transferring assets from one chain to another.

Copy link
Contributor

Choose a reason for hiding this comment

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

nit: orchestration -> Orchestration


Creates an account on the omniflixhub chain.
The `contract` function when wrapped inside `withOrchestration` defines the [`start` function](#start-function) which is the entry point of the contract. The contract exports a `start` function [below](#start-function). It is merely a convention/convenience that we define a more abstract `contract` function here and pass it to `withOrchestration`. The `contract` function parameters include:
Copy link
Member

Choose a reason for hiding this comment

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

There needs to be a separate h3 for the start function below for the link to work. It doesn't, right now.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Good catch. Will add back.

Comment on lines +62 to +64
harden({
give: {},
want: {},
exit: M.any()
})
Copy link
Member

Choose a reason for hiding this comment

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

Can we add a line or two about why this contract doesn't have or expect any give/want terms?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I don't feel the need for it - this would raise more questions that rather not be answer here.

```

### `contract` Function Parameters:
---
Copy link
Member

Choose a reason for hiding this comment

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

Are the double section separators intentional? They look weird.
Screenshot 2024-10-02 at 4 01 16 AM

Copy link
Contributor Author

Choose a reason for hiding this comment

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

No - let me fix that.

@amessbee amessbee requested a review from mujahidkay October 3, 2024 13:40
@amessbee
Copy link
Contributor Author

amessbee commented Oct 3, 2024

@mujahidkay please re-review!

@amessbee amessbee force-pushed the ms/update-unbond-walkthrough branch from e83589c to 1a2fc75 Compare October 4, 2024 14:39
@amessbee amessbee merged commit adac99a into main Oct 7, 2024
6 checks passed
@amessbee amessbee deleted the ms/update-unbond-walkthrough branch October 7, 2024 04:11
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.

3 participants