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

docs: drop all references to reallocate() and its helpers #1266

Merged
merged 3 commits into from
Feb 18, 2025

Conversation

Chris-Hibbert
Copy link
Collaborator

@Chris-Hibbert Chris-Hibbert commented Jan 22, 2025

closes: #798
See #10871

We converted from zcf.reallocate() to zcf.atomicRearrange() over the course of several releases. The old code will be completely gone as of #10871. This PR cleans up the last of the remaining documentation.

Copy link
Member

@dckc dckc left a comment

Choose a reason for hiding this comment

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

approved presuming you'll make the requested changes

contract-->>-zoe: reallocate()
contract-->>-zoe: atomicRearrange()
Copy link
Member

Choose a reason for hiding this comment

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

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

That page also has a link to a web editor which works fine for small diagrams like this, and allowed me to save as svg.

@@ -21,7 +21,7 @@ Trading with a contract using Zoe typically goes through these steps:
1. Parties call [E(zoe).offer(invitation, proposal, assets)](/reference/zoe-api/zoe#e-zoe-offer-invitation-proposal-paymentpkeywordrecord-offerargs). Zoe escrows the assets.
2. Zoe relays the proposal to the contract identified in the invitation.
3. The contract handles proposals using its custom business logic.
4. The contract instructs Zoe to [reallocate](/reference/zoe-api/zoe-contract-facet#zcf-reallocate-seats) assets among the parties.
4. The contract instructs Zoe to [reallocate](/reference/zoe-api/zoe-contract-facet.html#zcf-atomicrearrange-transfers) assets among the parties.
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
4. The contract instructs Zoe to [reallocate](/reference/zoe-api/zoe-contract-facet.html#zcf-atomicrearrange-transfers) assets among the parties.
4. The contract instructs Zoe to [reallocate](/reference/zoe-api/zoe-contract-facet#zcf-atomicrearrange-transfers) assets among the parties.

cf writing links

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

done

Copy link

cloudflare-workers-and-pages bot commented Jan 23, 2025

Deploying documentation with  Cloudflare Pages  Cloudflare Pages

Latest commit: 9693576
Status: ✅  Deploy successful!
Preview URL: https://3c253471.documentation-7tp.pages.dev
Branch Preview URL: https://10871-excisereallocate.documentation-7tp.pages.dev

View logs

Copy link

github-actions bot commented Jan 23, 2025

Cloudflare deployment logs are available here

mergify bot added a commit to Agoric/agoric-sdk that referenced this pull request Feb 16, 2025
closes: #6679

## Description

Removes the last vestiges of `zcf.reallocate()` and staged allocations.

### Security Considerations

The deprecated code turned out to be a bug farm. We've had no problems with the replacement.

### Scaling Considerations

None.

### Documentation Considerations

A separate PR ([Docs:#1266](Agoric/documentation#1266)) will remove the documentation. It has been marked deprecated for quite some time.

### Testing Considerations

Removed tests. All the new code (using `atomicRearrange`) has had tests all along.

### Upgrade Considerations

No known code uses the deprecated functionality.  These changes are confined to ZCF. It won't matter when or if Zoe gets upgraded. The next time we bump the ZCF version, new and upgraded contracts will start using the new ZCF, but there's no hurry  to make that happen.
@Chris-Hibbert Chris-Hibbert added the automerge:squash Mergify automerge:squash label Feb 18, 2025
Copy link
Contributor

mergify bot commented Feb 18, 2025

This pull request has been removed from the queue for the following reason: pull request dequeued.

Pull request #1266 has been dequeued. The pull request could not be merged. This could be related to an activated branch protection or ruleset rule that prevents us from merging. (details: Required status check "build (18.x)" is in progress.)

You should look at the reason for the failure and decide if the pull request needs to be fixed or if you want to requeue it.

If you want to requeue this pull request, you need to post a comment with the text: @mergifyio requeue

@Chris-Hibbert
Copy link
Collaborator Author

I don't understand what failed. I'll try requeuing.

@Mergifyio requeue

@Chris-Hibbert
Copy link
Collaborator Author

@Mergifyio requeue

Copy link
Contributor

mergify bot commented Feb 18, 2025

requeue

✅ The queue state of this pull request has been cleaned. It can be re-embarked automatically

@mergify mergify bot merged commit 225e91a into main Feb 18, 2025
8 checks passed
@mergify mergify bot deleted the 10871-exciseReallocate branch February 18, 2025 19:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
automerge:squash Mergify automerge:squash Zoe
Projects
None yet
Development

Successfully merging this pull request may close these issues.

prepare for migration to zcf atomicTransfer()
2 participants