ipor-fusion 4.0.0.dev315__tar.gz → 4.0.0.dev319__tar.gz

{ipor_fusion-4.0.0.dev315 → ipor_fusion-4.0.0.dev319}/AGENTS.md

@@ -82,8 +82,7 @@ mirrors the CCIP event registry from a checkout at its own `CONTRACTS_REVISION`.
 `test_solidity_compiler.py` unit-tests that compiler helper (`tests/_foundry.py`)
 offline, with `forge` and `git` mocked. The checkout-based tests above skip when their
 external prerequisites are unavailable. `test_hypercore_live.py`,
-`test_hypercore_deployment.py` and `test_hypercore_simulation.py` need
-`HYPEREVM_PROVIDER_URL` as well.
+and `test_hypercore_deployment.py` need `HYPEREVM_PROVIDER_URL` as well.
 HyperCore (market 55) cannot be simulated directly: the HyperEVM RPC ignores code
 overrides at the precompile addresses `0x800`–`0x813`, and the public Hyperliquid RPC
 has no `eth_simulateV1`. `tests/_hypercore_shadow.py` therefore compiles the HyperCore
@@ -93,8 +92,12 @@ CoreWriter constants redirected to ordinary addresses, proves the rest is identi
 the deployed runtimes, and `tests/_hypercore_model.py` answers those addresses through
 `VaultSimulator.with_state_override_provider`. Core never applies anything there: the
 tests prove EVM validation under supplied Core state. `test_hypercore_simulation.py`
-runs one vault cycle; it skips without the source directory and needs
-`HYPEREVM_PROVIDER_URL`.
+pins the shadow guard offline. `test_simulate_examples_hyperevm.py` runs the HyperCore
+example on the official deployment (`fixtures/hypercore_official.json`) at its pinned
+block: the wiring needs only `HYPEREVM_PROVIDER_URL`; the Core leg also needs the source
+directory at the fixture's `build.source_revision` and compiles with its
+`build.optimizer_runs` (the deployed set reproduces only with that setting, not the
+checkout's default profile), the pending reader included.
 
 ## Conventions
 

{ipor_fusion-4.0.0.dev315 → ipor_fusion-4.0.0.dev319}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ipor-fusion
-Version: 4.0.0.dev315
+Version: 4.0.0.dev319
 Summary: The IPOR Fusion SDK for Python
 Project-URL: homepage, https://ipor.io
 Project-URL: repository, https://github.com/IPOR-Labs/ipor-fusion.py
@@ -392,6 +392,11 @@ ever signed or broadcast.
 - [External-state margin leg](https://github.com/IPOR-Labs/ipor-fusion.py/blob/main/examples/external_state_margin_leg_base.py) — a vault whose capital
   sits off-chain: typed market-50 substrates, a dual-custodian propose/confirm marking the NAV,
   the scheduled-withdrawal prep an alpha performs, and a mismatched confirmation being rejected.
+- [HyperCore vault on the official deployment](https://github.com/IPOR-Labs/ipor-fusion.py/blob/main/examples/hypercore_vault_official_deployment_hyperevm.py) —
+  a HyperEVM vault that trades on Hyperliquid Core (market 55, preview): wiring the published
+  HyperCore fuses, pre-hooks and grants on a factory clone, and building the Core leg (bridge,
+  dex transfers, an order and its reduce-only close, Core → EVM) as unsigned `execute` calldata.
+  Core execution is never simulated; see the example for what is.
 ```bash
 export BASE_PROVIDER_URL="https://base-mainnet.g.alchemy.com/v2/YOUR_KEY"
 uv run python examples/simple_aave_v3_supply_base.py
@@ -403,6 +408,13 @@ No RPC key? `BASE_PROVIDER_URL=https://mainnet.base.org` (Base's public RPC) run
 the box — it supports `eth_simulateV1` and serves their pinned blocks. It is rate-limited, so use a
 dedicated archive node for repeated or CI runs.
 
+The HyperCore example runs on HyperEVM:
+
+```bash
+export HYPEREVM_PROVIDER_URL="https://YOUR_HYPEREVM_ARCHIVE_NODE"
+uv run python examples/hypercore_vault_official_deployment_hyperevm.py
+```
+
 ## Public API and stability
 
 The supported API is `ipor_fusion.__all__`: import from `ipor_fusion`. Removing or

{ipor_fusion-4.0.0.dev315 → ipor_fusion-4.0.0.dev319}/README.md

@@ -343,6 +343,11 @@ ever signed or broadcast.
 - [External-state margin leg](https://github.com/IPOR-Labs/ipor-fusion.py/blob/main/examples/external_state_margin_leg_base.py) — a vault whose capital
   sits off-chain: typed market-50 substrates, a dual-custodian propose/confirm marking the NAV,
   the scheduled-withdrawal prep an alpha performs, and a mismatched confirmation being rejected.
+- [HyperCore vault on the official deployment](https://github.com/IPOR-Labs/ipor-fusion.py/blob/main/examples/hypercore_vault_official_deployment_hyperevm.py) —
+  a HyperEVM vault that trades on Hyperliquid Core (market 55, preview): wiring the published
+  HyperCore fuses, pre-hooks and grants on a factory clone, and building the Core leg (bridge,
+  dex transfers, an order and its reduce-only close, Core → EVM) as unsigned `execute` calldata.
+  Core execution is never simulated; see the example for what is.
 ```bash
 export BASE_PROVIDER_URL="https://base-mainnet.g.alchemy.com/v2/YOUR_KEY"
 uv run python examples/simple_aave_v3_supply_base.py
@@ -354,6 +359,13 @@ No RPC key? `BASE_PROVIDER_URL=https://mainnet.base.org` (Base's public RPC) run
 the box — it supports `eth_simulateV1` and serves their pinned blocks. It is rate-limited, so use a
 dedicated archive node for repeated or CI runs.
 
+The HyperCore example runs on HyperEVM:
+
+```bash
+export HYPEREVM_PROVIDER_URL="https://YOUR_HYPEREVM_ARCHIVE_NODE"
+uv run python examples/hypercore_vault_official_deployment_hyperevm.py
+```
+
 ## Public API and stability
 
 The supported API is `ipor_fusion.__all__`: import from `ipor_fusion`. Removing or

{ipor_fusion-4.0.0.dev315 → ipor_fusion-4.0.0.dev319}/examples/README.md

@@ -38,6 +38,21 @@ transaction.
   brings the margin home and releases it for a user's scheduled withdrawal, then
   demonstrates the executor rejecting a confirmation that does not match its
   proposal.
+- [`hypercore_vault_official_deployment_hyperevm.py`](hypercore_vault_official_deployment_hyperevm.py) --
+  a vault that is itself a Hyperliquid Core account (HyperCore, market 55; a
+  preview feature). No live vault uses the official HyperCore contracts yet, so
+  it clones a USDC vault from the official HyperEVM factory, wires the published
+  HyperCore fuses, balance fuse and pre-hooks with narrow market-55 grants, reads
+  the post-deployment checklist back, checks its constants against live Core
+  metadata at head, and builds the Core leg (EVM -> Core bridge, spot -> xyz dex,
+  an IOC order and its reduce-only close, dex -> spot, Core -> EVM) as unsigned
+  `execute` calldata. Core execution is never simulated, and the HyperCore read
+  precompiles do not run in `eth_simulateV1`: the default run stops before the
+  Core leg. Its RPC-gated test runs the Core leg too, with the fuses recompiled
+  from source against stand-in precompile answers (EVM acceptance only); it needs
+  `HYPEREVM_PROVIDER_URL`, `IPOR_FUSION_HYPERCORE_SOURCE_DIR` (an ipor-fusion
+  checkout at the release the deployment was built from) and `forge`, and skips
+  without them, which is how pull-request CI runs it.
 
 ## Prerequisites