https://github.com/pinax-network/substreams-antelope

Substreams for Antelope
https://github.com/pinax-network/substreams-antelope

antelope substreams thegraph

Last synced: about 2 months ago
JSON representation

Substreams for Antelope

• Host: GitHub
• URL: https://github.com/pinax-network/substreams-antelope
• Owner: pinax-network
• License: apache-2.0
• Created: 2023-01-04T20:12:30.000Z (over 1 year ago)
• Default Branch: develop
• Last Pushed: 2024-03-27T14:22:49.000Z (3 months ago)
• Last Synced: 2024-04-29T08:44:02.389Z (2 months ago)
• Topics: antelope, substreams, thegraph
• Language: Rust
• Homepage: https://docs.rs/substreams-antelope
• Size: 655 KB
• Stars: 1
• Watchers: 5
• Forks: 0
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE-APACHE

Lists

• awesome-substreams - Substreams Antelope - This library contains the generated protobuffer for the Antelope blocks as well as helper methods to extract and parse block data. (Blockchains / Substreams)

README

        
# [`Substreams`](https://substreams.streamingfast.io/) for [**Antelope**](http://antelope.io/)

[](https://github.com/pinax-network/substreams-antelope)

[](https://crates.io/crates/substreams-antelope)

[](https://docs.rs/substreams-antelope)

[](https://github.com/pinax-network/substreams-antelope/actions?query=branch%3Adevelop)

> This library contains the generated protobuffer for the [Antelope blocks](https://github.com/pinax-network/firehose-antelope/blob/develop/proto/sf/antelope/type/v1/type.proto) as well as helper methods to extract and parse block data.

## 📖 Documentation

### https://docs.rs/substreams-antelope

### Further resources

- [Substreams documentation](https://substreams.streamingfast.io)

## Install

```

$ cargo add substreams-antelope

```

## Usage

Refer to [Docs.rs](https://docs.rs/substreams-antelope/latest/substreams_antelope/struct.Block.html#implementations) for helper methods on `Block` that extract action and transaction iterators from the Antelope block.

**Cargo.toml**

```toml

[dependencies]

substreams = "0.5"

substreams-antelope = "0.4"

```

**src/lib.rs**

```rust

use substreams::prelude::*;

use substreams::errors::Error;

use substreams_antelope::{Block, ActionTraces};

#[substreams::handlers::map]

fn map_action_traces(block: Block) -> Result {

    let mut action_traces = vec![];

    for trx in block.transaction_traces() {

        for trace in trx.action_traces {

            action_traces.push(trace);

        }

    }

    Ok(ActionTraces { action_traces })

}

```

Or, using `actions()` helper method to filter all actions of `Statelog` type from `myaccount` account. As a parameter you can specify a list of contract account names to include actions from, that can be empty if you want actions with this signature from any contract account.

**src/lib.rs**

```rust

#[substreams::handlers::map]

fn map_actions(param_account: String, block: substreams_antelope::Block) -> Result {

    Ok(Actions {

        transfers: block.actions::(&["eosio.token"])

            .map(|(action, trace)| Transfer {

                // set action fields

            })

            .collect(),

    })

}

```

## Using Abigen

To generate ABI bindings for your smart contract you can add `abi/contract.abi.json` file containing the smart contract ABI, as well as the following `build.rs` file to the root of your project. This will ensure that `src/abi/contract.rs` module containing Rust bindings for your smart contract is always generated in your project:

**build.rs**

```rust

fn main() {

    substreams_antelope::Abigen::new("Contract", "abi/gems.blend.abi.json")

        .expect("failed to load abi")

        .generate()

        .expect("failed to generate contract")

        .write_to_file("src/abi/gems.blend.abi.rs")

        .expect("failed to write contract");

}

```