test: add integration tests

.github/workflows/bindings.yml → .github/workflows/crates.yml

@@ -1,4 +1,4 @@
-name: Bindings
+name: Crates
 
 on:
   push:
@@ -8,10 +8,13 @@ on:
 
 jobs:
   tests:
-    name: Bindings Tests
+    name: Crates Tests
     runs-on: macos-latest
     env:
       ALCHEMY_API_KEY: ${{ secrets.ALCHEMY_API_KEY }}
+      QUEUE_BASE_URL: ${{ secrets.QUEUE_BASE_URL }}
+      QUEUE_AUTH_TOKEN: ${{ secrets.QUEUE_AUTH_TOKEN }}
+      RISC0_SKIP_BUILD_KERNELS: true
 
     steps:
       - name: Checkout repository
@@ -41,17 +44,17 @@ jobs:
         with:
           path: |
             target
-          key: rust-${{ runner.os }}-${{ hashFiles('**/Cargo.lock') }}
+          key: rust-${{ runner.os }}-${{ hashFiles('Cargo.lock') }}
           restore-keys: rust-
 
       - name: Run rustfmt
-        run: just bindings-fmt-check
+        run: just crates-fmt-check
 
-      - name: Build Bindings
-        run: just bindings-build
+      - name: Build
+        run: just crates-build
 
-      - name: Lint Bindings
-        run: just bindings-lint
+      - name: Lint
+        run: just crates-lint
 
       - name: Run Tests
-        run: just bindings-test
+        run: just crates-test

CONTEXT.md

@@ -0,0 +1,29 @@
+# Generic Call Forwarder
+
+The forwarder contract and integration-test layer that lets ARM resources trigger
+**arbitrary EVM calls** through the [Anoma EVM protocol adapter](https://github.com/anoma/pa-evm).
+
+## Language
+
+**Generic Call Forwarder**:
+The EVM contract through which the protocol adapter executes a list of arbitrary
+calls on behalf of an action. Use "generic call forwarder" for the contract.
+
+**Generic Call**:
+A single `(to, value, data)` EVM call carried by a resource and executed by the
+forwarder. A resource's label commits to the calls it authorizes.
+
+**Forwarder**:
+The generic call forwarder contract (above) — the same forwarder role the protocol
+adapter drives in other applications.
+
+## Note on upstream names
+
+`generic_call_library` and `generic_call_witness` (the resource logic, witness
+types, and underlying circuit) live in `anoma/generic-call-resource` and keep those
+names — they are immutable from this repo's perspective.
+
+The integration-test crate reuses the AnomaPay ERC20 wrap / transfer / unwrap
+fixtures (via a dev-dependency on `anomapay-erc20-forwarder-integration-test`) to
+move WETH into a shielded resource before driving a generic call; see that repo's
+`CONTEXT.md` for those terms.