refactor: generalized abi decode for Golang + JS

.cursor/rules/blockchain-interactions.mdc

@@ -0,0 +1,153 @@
+---
+description: 
+globs: 
+alwaysApply: true
+---
+# Blockchain Interactions in WAVS Components
+
+Use the `wavs-wasi-utils` crate and Alloy ecosystem crates to interact with Ethereum and EVM-compatible chains from WAVS components. Configure chains in `wavs.toml` and generate Rust types from Solidity using the `sol!` macro.
+
+1. **Setup dependencies in Cargo.toml:**
+
+```toml
+[dependencies]
+wit-bindgen-rt = { version = "0.42.1", features = ["bitflags"] }
+wit-bindgen = "0.42.1"
+wavs-wasi-utils = "0.4.0-beta.4"
+wstd = "0.5.3"
+
+alloy-sol-macro = { version = "1.1.0", features = ["json"] }
+alloy-sol-types = "1.1.0"
+alloy-network = "0.15.10"
+alloy-provider = { version = "0.15.10", default-features = false, features = ["rpc-api"] }
+alloy-rpc-types = "0.15.10"
+alloy-contract = "0.15.10"
+
+anyhow = "1.0.98"
+serde = { version = "1.0.219", features = ["derive"] }
+serde_json = "1.0.140"
+```
+
+Use `workspace = true` if managing versions centrally.
+
+2. **Configure chains in `wavs.toml`:**
+
+```toml
+[default.chains.evm.local]
+chain_id = "31337"
+ws_endpoint = "ws://localhost:8545"
+http_endpoint = "http://localhost:8545"
+poll_interval_ms = 7000
+
+[default.chains.evm.ethereum]
+chain_id = "1"
+ws_endpoint = "wss://eth.drpc.org"
+http_endpoint = "https://eth.drpc.org"
+```
+
+3. **Generate Rust types from Solidity with `sol!` macro:**
+
+```rust
+mod solidity {
+    use alloy_sol_macro::sol;
+
+    // From Solidity file
+    sol!("../../src/interfaces/ITypes.sol");
+
+    // Or inline Solidity definitions
+    sol! {
+        struct TriggerInfo {
+            uint64 triggerId;
+            bytes data;
+        }
+
+        event NewTrigger(TriggerInfo _triggerInfo);
+    }
+}
+```
+
+4. **Access chain config and create provider:**
+
+```rust
+use crate::bindings::host::get_evm_chain_config;
+use alloy_network::Ethereum;
+use alloy_provider::RootProvider;
+use wavs_wasi_utils::evm::new_evm_provider;
+
+let chain_config = get_evm_chain_config("local").unwrap();
+let provider: RootProvider<Ethereum> = new_evm_provider::<Ethereum>(
+    chain_config.http_endpoint.unwrap(),
+);
+```
+
+5. **Example: Query ERC721 NFT balance**
+
+```rust
+use crate::bindings::host::get_evm_chain_config;
+use alloy_network::Ethereum;
+use alloy_provider::RootProvider;
+use alloy_sol_types::sol;
+use wavs_wasi_utils::evm::{alloy_primitives::{Address, U256}, new_evm_provider};
+use alloy_rpc_types::TransactionInput;
+use wstd::runtime::block_on;
+
+sol! {
+    interface IERC721 {
+        function balanceOf(address owner) external view returns (uint256);
+    }
+}
+
+pub fn query_nft_ownership(address: Address, nft_contract: Address) -> Result<bool, String> {
+    block_on(async move {
+        let chain_config = get_evm_chain_config("local").unwrap();
+        let provider: RootProvider<Ethereum> = new_evm_provider::<Ethereum>(
+            chain_config.http_endpoint.unwrap()
+        );
+
+        let balance_call = IERC721::balanceOf { owner: address };
+
+        let tx = alloy_rpc_types::eth::TransactionRequest {
+            to: Some(TxKind::Call(nft_contract)),
+            input: TransactionInput { input: Some(balance_call.abi_encode().into()), data: None },
+            ..Default::default()
+        };
+
+        let result = provider.call(tx).await.map_err(|e| e.to_string())?;
+        let balance: U256 = U256::from_be_slice(&result);
+        Ok(balance > U256::ZERO)
+    })
+}
+```
+
+6. **Best practices and guidelines:**
+
+- Use `wavs.toml` for chain configuration to avoid hardcoding endpoints.
+- Use `sol!` macro to generate Rust bindings from Solidity interfaces for type safety.
+- Use `new_evm_provider` to create providers from chain config endpoints.
+- Use `block_on` from `wstd` to run async code synchronously in components.
+- Handle errors with `anyhow` or proper error propagation.
+- Rebuild after updating Solidity files to regenerate Rust types.
+
+7. **Useful crates:**
+
+- `wavs-wasi-utils`: HTTP and blockchain interaction utilities, including `decode_event_log_data` macro.
+- Alloy crates (`alloy-primitives`, `alloy-provider`, `alloy-network`, `alloy-sol-types`, `alloy-sol-macro`): Ethereum types, network, ABI handling, and Solidity macro.
+- `wstd`: WASI standard library with async utilities.
+- `serde`/`serde_json`: Serialization and JSON handling.
+- `anyhow`: Error handling.
+
+For more information:
+- [wavs-wasi-utils crate documentation](mdc:https:/docs.rs/wavs-wasi-utils/latest/wavs_wasi_utils/index.html)
+- [Alloy sol! macro documentation](mdc:https:/docs.rs/alloy-sol-macro/latest/alloy_sol_macro/macro.sol.html)
+- [Utilities and crates page](mdc:utilities)
+- [wavs-wasi-utils docs](mdc:https:/docs.rs/wavs-wasi-utils/latest/wavs_wasi_utils)
+- [Alloy documentation](mdc:https:/docs.rs/alloy/latest/alloy)
+- [Example querying NFT ownership](mdc:https:/github.com/Lay3rLabs/wavs-art/blob/main/components/autonomous-artist/src/evm.rs)
+- [alloy-primitives](mdc:https:/docs.rs/alloy-primitives/latest/alloy_primitives)
+- [alloy-provider](mdc:https:/docs.rs/alloy-provider/latest/alloy_provider)
+- [alloy-network](mdc:https:/docs.rs/alloy-network/latest/alloy_network)
+- [alloy-sol-types](mdc:https:/docs.rs/alloy-sol-types/latest/alloy_sol_types)
+- [wstd](mdc:https:/docs.rs/wstd/latest/wstd)
+- [serde](mdc:https:/docs.rs/serde/latest/serde)
+- [serde_json](mdc:https:/docs.rs/serde_json/latest/serde_json)
+- [](mdc:https:/docs.rs/anyhow/latest/anyhow)

.cursor/rules/commands.mdc

@@ -0,0 +1,54 @@
+---
+description: 
+globs: 
+alwaysApply: true
+---
+# Makefile Commands for WAVS Development
+
+This rule summarizes the CLI commands available in the WAVS Makefile for building, testing, deploying, and managing WAVS components and services.
+
+1. Common commands:
+   - `make help`: Show help information.
+   - `build`: Build the project.
+   - `wasi-build`: Build WAVS WASI components. Uses `WASI_BUILD_DIR`.
+   - `wasi-exec`: Execute WAVS WASI components. Requires `COMPONENT_FILENAME`, `COIN_MARKET_CAP_ID`.
+   - `clean`: Clean project files.
+   - `clean-docker`: Remove unused Docker containers.
+   - `fmt`: Format Solidity and Rust code.
+   - `test`: Run tests.
+   - `setup`: Install initial dependencies.
+   - `start-all-local`: Start local services like Anvil and IPFS.
+   - `update-submodules`: Update git submodules.
+   - `check-requirements`: Verify system requirements.
+
+2. Deployment and service management:
+   - `upload-component`: Upload WAVS component. Requires `COMPONENT_FILENAME`, `WAVS_ENDPOINT`.
+   - `deploy-service`: Deploy WAVS component service JSON. Requires `SERVICE_URL`, `CREDENTIAL`, `WAVS_ENDPOINT`.
+   - `get-trigger-from-deploy`: Get trigger address from deploy script.
+   - `get-submit-from-deploy`: Get submit address from deploy script.
+   - `get-trigger`: Get trigger ID. Requires `SERVICE_TRIGGER_ADDR`, `RPC_URL`.
+   - `show-result`: Show result. Requires `SERVICE_SUBMISSION_ADDR`, `TRIGGER_ID`, `RPC_URL`.
+   - `upload-to-ipfs`: Upload service config to IPFS. Requires `SERVICE_FILE`, optional `[PINATA_API_KEY]`.
+
+3. Operator management:
+   - `operator-list`: List AVS operators. Requires `ENV_FILE`.
+   - `operator-register`: Register AVS operators. Requires `ENV_FILE`, `AVS_PRIVATE_KEY`.
+
+Guidelines:
+- Use environment variables as indicated for commands requiring parameters.
+- Run `make help` to see available commands.
+- Use `clean` and `clean-docker` to maintain a clean environment.
+- Format code regularly with `fmt` to maintain consistency.
+- Use `setup` before starting development to install dependencies.
+
+Example usage:
+```bash
+make build
+make wasi-build
+make upload-component COMPONENT_FILENAME=component.wasm WAVS_ENDPOINT=https://wavs.example.com
+make operator-register ENV_FILE=.env AVS_PRIVATE_KEY=key123
+```
+
+For more information:
+- [WAVS Documentation](mdc:https:/docs.wavs.example.com)
+- [](mdc:https:/www.gnu.org/software/make/manual/make.html)