chore: add license file

.github/workflows/license_headers_check.yml

@@ -0,0 +1,35 @@
+name: License headers check
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  check:
+    name: License headers check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
+      - name: Install addlicense
+        run: |
+          wget https://github.com/google/addlicense/releases/download/v1.1.1/addlicense_1.1.1_Linux_x86_64.tar.gz
+          tar -xzf addlicense_1.1.1_Linux_x86_64.tar.gz
+          sudo mv addlicense /usr/local/bin
+      - name: Check license headers
+        run: >
+          addlicense \
+            -check \
+            -c "Semiotic AI, Inc." \
+            -l "apache" \
+            -s=only \
+            -ignore '.github/workflows/*.yml' \
+            -ignore '.github/*.yml' \
+            -ignore '.github/workflows/*.yaml' \
+            -ignore '.github/*.yaml' \
+            -ignore 'crates/forrestrie/protos/type.proto' \
+            -ignore 'crates/firehose-protos/protos/bstream.proto' \
+            -ignore 'crates/firehose-protos/protos/block.proto' \
+            -ignore 'crates/firehose-protos/protos/firehose.proto' \
+            .

crates/flat-files-decoder/LICENSE → LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [yyyy] [name of copyright owner]
+   Copyright 2024- Semiotic AI Inc.
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

crates/firehose-client/examples/fetch_beacon.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 //! # Fetch Beacon Block
 //!
 //! Demonstrates how to fetch a single block from Beacon Firehose, using the `Fetch` API.

crates/firehose-client/examples/fetch_ethereum.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 //! # Fetch Ethereum Block
 //!
 //! Demonstrates how to fetch a single block from Ethereum firehose.

crates/firehose-client/examples/stream_beacon.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 //! # Example: Stream Beacon Blocks
 //!
 //! Demonstrates how to stream a range of blocks from Firehose Beacon

crates/firehose-client/examples/stream_ethereum.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 //! # Example: Stream Ethereum Blocks
 //!
 //! This example demonstrates how to stream Ethereum blocks using the Firehose client.

crates/firehose-client/src/client.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 use std::str::FromStr;
 
 use crate::error::ClientError;

crates/firehose-client/src/error.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 use http::uri::InvalidUri;
 use thiserror::Error;
 

crates/firehose-client/src/lib.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 //! # Rust Firehose Client
 //!
 //! Rust implementation of a client for the [StreamingFast Firehose](https://firehose.streamingfast.io/)

crates/firehose-client/src/tls.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 use once_cell::sync::Lazy;
 
 use tonic::transport::ClientTlsConfig;

crates/firehose-protos-examples/examples/receipt_root.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 use alloy_primitives::FixedBytes;
 use firehose_client::{Chain, FirehoseClient};
 use firehose_protos::EthBlock as Block;

crates/firehose-protos-examples/src/lib.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 //! # Firehose Protos Examples
 //!
 //! Examples that use methods implemented on the Rust-compiled Firehose

crates/firehose-protos/build.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 use prost_build::Config;
 use std::{env, path::PathBuf};
 

crates/firehose-protos/src/error.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 use thiserror::Error;
 
 /// Custom error variants for Verifiable Extraction protobuffer types.

crates/firehose-protos/src/ethereum_v2/access.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 use crate::error::ProtosError;
 
 use super::AccessTuple;

crates/firehose-protos/src/ethereum_v2/eth_block.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 use super::{Block, BlockHeader, TransactionReceipt, TransactionTrace};
 use alloy_primitives::{hex, Address, Bloom, FixedBytes, Uint, B256};
 use alloy_rlp::{Encodable, Header as RlpHeader};

crates/firehose-protos/src/ethereum_v2/log.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 use alloy_primitives::{hex, Address, Bytes, B256};
 use reth_primitives::LogData;
 

crates/firehose-protos/src/ethereum_v2/mod.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 //! Firehose Ethereum-related data structures and operations.
 //! See the protobuffer definitions section of the README for more information.
 //!

crates/firehose-protos/src/ethereum_v2/transaction.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 use std::fmt::Display;
 
 use alloy_consensus::{TxEip1559, TxEip2930, TxLegacy};

crates/firehose-protos/src/firehose_v2/mod.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 pub mod request;
 
 tonic::include_proto!("sf.firehose.v2");

crates/firehose-protos/src/firehose_v2/request.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 use crate::BlockNumber;
 
 use super::{single_block_request::Reference, SingleBlockRequest};

crates/firehose-protos/src/lib.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 //! # Verifiable Extraction Protocol Buffers in Rust
 //!
 //! This module provides Rust implementations of StreamingFast's protocol buffer definitions,

crates/flat-files-decoder/benches/decoder.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 extern crate rand;
 
 use criterion::{black_box, criterion_group, criterion_main, Criterion};

crates/flat-files-decoder/benches/stream_blocks.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 use std::{
     fs::{self, File},
     io::BufReader,

crates/flat-files-decoder/examples/cli.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 use std::{
     fs::{self, DirEntry, File},
     io::{self, BufReader, BufWriter, Write},

crates/flat-files-decoder/examples/compression.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 //! Example of reading blocks from compressed and uncompressed files.
 //!
 //! This example demonstrates how to read blocks from compressed and uncompressed files.

crates/flat-files-decoder/examples/read_blocks.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 use std::{
     fs::File,
     io::{BufReader, BufWriter, Cursor, Write},

crates/flat-files-decoder/src/dbin.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 use std::io::{self, Read};
 
 use crate::error::DecoderError;
@@ -31,7 +34,7 @@ const SUPPORTED_DBIN_VERSION: u8 = 0;
 
 /// Work with a `.dbin` flat file.
 ///
-/// Developed by StreamingFast, dbin is a simple file storage format to pack a stream of protobuffer messages.    
+/// Developed by StreamingFast, dbin is a simple file storage format to pack a stream of protobuffer messages.
 /// For more information, see [the dbin format documentation](https://github.com/streamingfast/dbin?tab=readme-ov-file).
 #[derive(Debug)]
 pub struct DbinFile {

crates/flat-files-decoder/src/decoder.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 use std::io::{BufReader, Cursor, Read};
 
 use firehose_protos::{BstreamBlock, EthBlock as Block};
@@ -139,7 +142,7 @@ impl TryFrom<Reader> for Box<dyn Read> {
 
 /// Set the end block for the range of blocks to read, decode, and verify.
 ///
-/// Enum to handle the end block of the stream.    
+/// Enum to handle the end block of the stream.
 /// It can be the merge block, i.e. the last pre-merge block, or a specific block number.
 pub enum EndBlock {
     /// The last pre-merge block.

crates/flat-files-decoder/src/error.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 use thiserror::Error;
 
 /// Get custom error variants for issues with reading, decoding, and verifying flat files.

crates/flat-files-decoder/src/lib.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 //! # Flat Files Decoder
 //!
 //! Read, decode, and verify blockchain block flat files.

crates/forrestrie-examples/examples/block_roots_only_proof.rs

@@ -1,11 +1,14 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 //! # Inclusion Proofs for Block Roots Only
 //!
 //! For this test, we want to prove that a block_root is included in the `block_summary_root`
 //! field of a [`HistoricalSummary`] from the [`BeaconState`] historical_summaries List.
 //! A [`HistoricalSummary`] contains the roots of two Merkle trees, `block_summary_root` and
 //! `state_summary_root`.
 //! We are interested in the `block_summary_root` tree, whose leaves consists of the
-//! [`BeaconBlockHeader`] roots for one era (8192 consecutive slots).  
+//! [`BeaconBlockHeader`] roots for one era (8192 consecutive slots).
 //! For this test, we are using the state at the first [`Slot`] of an era to build the proof.
 //! We chose this [`Slot`] because it is the first [`Slot`] of an era, and all of the
 //! [`BeaconBlockHeader`] roots needed to construct the [`HistoricalSummary`] for this era are

crates/forrestrie-examples/examples/block_roots_proofs.rs

@@ -1,8 +1,11 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 //! # Block Roots Proofs
 //!
 //! We want to prove that a block_root is included in a [`HistoricalSummary`] from the [`BeaconState`] historical_summaries List.
 //! A [`HistoricalSummary`] contains the roots of two Merkle trees, block_summary_root and state_summary root.
-//! We are interested in the block_summary tree, whose leaves consists of the [`BeaconBlockHeader`] roots for one era (8192 consecutive slots).  
+//! We are interested in the block_summary tree, whose leaves consists of the [`BeaconBlockHeader`] roots for one era (8192 consecutive slots).
 //! For example, we could have used the state at [`Slot`] 8790016, which is the first [`Slot`] of era 1073, to build the proof.
 //! Because it is the first [`Slot`] of an era, all of the [`BeaconBlockHeader`] roots needed to construct the
 //! [`HistoricalSummary`] for this era are available in state.block_roots.

crates/forrestrie-examples/examples/empty_slot_hashes.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 //! # Empty Slot Block Hashes
 //!
 //! This example demonstrates that empty Beacon slots - slots with no execution block -

crates/forrestrie-examples/examples/fetch_and_verify_block.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 //! # Beacon Block and Header Root Consistency
 //!
 //! In Ethereum's Beacon chain, the beacon block root and the block header root should match

crates/forrestrie-examples/examples/historical_state_roots_proof.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 //! # Historical and state roots proof
 //!
 //! This example demonstrates how to prove the inclusion of historical state roots in the beacon state.

crates/forrestrie-examples/examples/historical_summary_proof.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 //! # Historical Summary Proof Given Historical Summaries Root
 //!
 //! This example demonstrates how to prove the inclusion of historical summaries in the beacon state.

crates/forrestrie-examples/examples/match_ethereum_to_beacon.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 //! # Ethereum Block to Beacon Slot Lookup Example
 //!
 //! This example performs a binary search to find the corresponding Beacon chain

crates/forrestrie-examples/examples/receipts_proof.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 //! # Receipts proof given an EL block's `receipt_root`
 //!
 //! This example shows how to generate an inclusion proof for a set of receipts of an EL block.

crates/forrestrie-examples/examples/single_block_post_merge_pre_capella_proof.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 //! Proof for  single block to be part of an era of beacon blocks using the [`HistoricalBatch`].
 //!
 //! Notice that A [`HistoricalBatch`]` isn't an accumulator, it is a list of block_roots and state_roots

crates/forrestrie-examples/examples/single_execution_block.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 //! # Prove Inclusion of a Single Execution Layer Block in the Canonical History of the Blockchain
 //!
 //! This example demonstrates how to prove the inclusion of a single execution layer block in the canonical

crates/forrestrie-examples/examples/verify-era.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 //! In this example, we verify a complete era of both beacon blocks and execution blocks.
 //! We first fetch a complete era of beacon blocks (8192 beacon blocks), compute the associated historical summary and
 //! compare it against the historical summary from a current consensus stated. We also extract the

crates/forrestrie-examples/examples/verify_block_inclusion_proof.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 //! # Verify Block Inclusion Proof
 //!
 //! In Ethereum's Beacon Chain, execution layer payloads are included in the block body.
@@ -13,7 +16,7 @@
 //! ```
 //!
 //! Similarly, the block body root is derived as follows:
-//!     
+//!
 //! ```rust
 //! let block_body_hash = block_body.tree_hash_root();
 //! ```

crates/forrestrie-examples/src/lib.rs

@@ -1 +1,2 @@
-
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0

crates/forrestrie/build.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 use prost_build::Config;
 use std::{env, path::PathBuf};
 

crates/forrestrie/src/beacon_block.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 use serde::{Deserialize, Serialize};
 use tree_hash::TreeHash;
 use types::{

crates/forrestrie/src/beacon_state.rs

@@ -1,3 +1,6 @@
+// Copyright 2024-, Semiotic AI, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
 use merkle_proof::MerkleTree;
 use primitive_types::H256;
 use serde::{Deserialize, Serialize};