avalanche 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c2715ac0dee6e2104552ea61fa836ad5836749acbc5b4fde6bcc99c3e0c2d61d
+  data.tar.gz: 751c8ff597d3bb0b8e707e65bd88dfecfa753a3d8d3ec6972da06304fa6680f8
+SHA512:
+  metadata.gz: 6e8baeae9864bc8594411e3d43fb9b486e86ee81219c091d1c3fd14122ee112b0f0a61df31b0f7ed2b3310b9cde43e4f26a431d95900872e2d446c8d25bd0ebb
+  data.tar.gz: d063ec6239bc5ecc875cb723a1a826a1ccc546001ceb0af7d7655d06f9ef559cb05748873a0270faf28bb68a5a4ca2238c87b5748715e76e5aa61bb41a54dfc9

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,8 @@
+AllCops:
+  TargetRubyVersion: 3.1
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2025-08-31
+
+- Initial release

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,132 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official email address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+[INSERT CONTACT METHOD].
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Andres Yebra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,153 @@
+# Avalanche Ruby SDK
+
+[Avalanche](https://www.avax.network/) is a decentralized, open-source Layer-1 blockchain platform developed.
+
+This Ruby SDK provides a convenient way to interact with the Avalanche APIs.
+
+[AvaCloud](https://www.avacloud.io/) is a powerful and flexible toolset designed to simplify the integration with AvaCloud's suite of blockchain services.
+
+
+## Documentation
+
+For detailed API documentation, please visit: [Avalanche API Documentation](https://developers.avacloud.io/introduction)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'avalanche'
+```
+
+And then execute:
+
+```bash
+$ bundle install
+```
+
+Or install it yourself as:
+
+```bash
+$ gem install avalanche
+```
+
+## Configuration
+
+Add the following configuration to `config/initializers/avalanche.rb`:
+
+```ruby
+Avalanche::AvaCloud.configure do |config|
+  config.api_key = "avacloud_api_key" 
+  config.network = "testnet"
+  config.chain_id = 1
+end
+```
+
+## Usage
+
+### Avalanche AvaCloud Data API
+
+```ruby
+chains = Avalanche::AvaCloud::Data::EVM::Chains.chains
+```
+
+```json
+{
+  "chains": [
+    {
+      "chainId": "<string>",
+      "status": "OK",
+      "chainName": "<string>",
+      "description": "<string>",
+      "platformChainId": "<string>",
+      "subnetId": "<string>",
+      "vmId": "<string>",
+      "vmName": "EVM",
+      "explorerUrl": "<string>",
+      "rpcUrl": "<string>",
+      "wsUrl": "<string>",
+      "isTestnet": true,
+      "utilityAddresses": {
+        "multicall": "<string>"
+      },
+      "networkToken": {
+        "name": "Wrapped AVAX",
+        "symbol": "WAVAX",
+        "decimals": 18,
+        "logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
+        "description": "<string>"
+      },
+      "chainLogoUri": "<string>",
+      "private": true,
+      "enabledFeatures": [
+        "nftIndexing"
+      ]
+    }
+  ]
+}
+```
+
+### Avalanche AvaCloud Metrics API
+
+```ruby
+metrics = Avalanche::AvaCloud::Metrics::Chains.chains
+```
+
+```json
+{
+  "chains": [
+    {
+      "evmChainId": 43114,
+      "chainName": "c_chain",
+      "blockchainId": "2q9e4r6Mu3U68nU1fYjgbR6JvwrRx36CohpAX5UQxse55x1Q5",
+      "subnetId": "11111111111111111111111111111111LpoYY",
+      "network": "mainnet"
+    }
+  ]
+}
+```
+
+### Avalanche AvaCloud Webhook API
+
+```ruby
+webhooks = Avalanche::AvaCloud::Webhooks::Webhook.lists
+```
+
+```json
+{
+  "webhooks": [
+    {
+      "id": "<string>",
+      "url": "<string>",
+      "chainId": "<string>",
+      "status": "active",
+      "createdAt": 123,
+      "name": "<string>",
+      "description": "<string>",
+      "eventType": "address_activity",
+      "metadata": {
+        "eventSignatures": [
+          "0x61cbb2a3dee0b6064c2e681aadd61677fb4ef319f0b547508d495626f5a62f64"
+        ],
+        "addresses": [
+          "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E"
+        ]
+      },
+      "includeInternalTxs": true,
+      "includeLogs": true
+    }
+  ]
+}
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/avalanche. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/avalanche/blob/master/CODE_OF_CONDUCT.md).
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the Avalanche project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/avalanche/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]

data/lib/avalanche/ava_cloud/base_api.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+require "faraday"
+require "faraday/retry"
+
+module Avalanche
+  module AvaCloud
+    # Base API class to connect with Data, Metrics and WebHook AvaCloud API.
+    class BaseApi
+      # Method to start a new Api connection.
+      # @param url_api [String]
+      # @param require_auth [Boolean]
+      # @return [Faraday::Connection]
+      def initialize(url_api:, require_auth: true)
+        @base_url_api = url_api
+        @require_auth = require_auth
+        @connection = Faraday.new(url: base_url_api) do |c|
+          c.request :json
+          c.response :json
+          c.use Faraday::Retry::Middleware
+          c.adapter Faraday.default_adapter
+          c.headers = headers
+        end
+      end
+
+      # Method to make GET request.
+      # @param path [String]
+      # @param params [Hash{Symbol->Object}]
+      # @return [Hash{Symbol->Object}]
+      def get(path, params = {})
+        handle_response do
+          @connection.get(path, params)
+        end
+      end
+
+      # Method to make POST request.
+      # @param path [String]
+      # @param body [Hash{Symbol->Object}]
+      # @return [Hash{Symbol->Object}]
+      def post(path, body = {})
+        handle_response do
+          @connection.post(path, body)
+        end
+      end
+
+      # Method to make PUT request.
+      # @param path [String]
+      # @param body [Hash{Symbol->Object}]
+      # @return [Hash{Symbol->Object}]
+      def put(path, body = {})
+        handle_response do
+          @connection.put(path, body)
+        end
+      end
+
+      private
+
+      attr_reader :base_url_api, :require_auth
+
+      # Method to set Http headers.
+      # @return [Hash{Symbol->Object}]
+      def headers
+        {
+          "x-glacier-api-key" => require_auth ? Avalanche::AvaCloud.config.api_key : nil,
+          "Content-Type" => "application/json"
+        }
+      end
+
+      # Method to handle API response(body, status, code).
+      # @return [Hash{Symbol->Object}]
+      def handle_response # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+        response = yield
+        case response.status
+        when 200..299
+          response.body
+        when 400
+          raise Avalanche::AvaCloud::BadRequestError.new(response.status, response.body)
+        when 401
+          raise Avalanche::AvaCloud::UnauthorizedError.new(response.status, response.body)
+        when 404
+          raise Avalanche::AvaCloud::NotFoundError.new(response.status, response.body)
+        when 500..599
+          raise Avalanche::AvaCloud::ServerError.new(response.status, response.body)
+        else
+          raise Avalanche::AvaCloud::APIError.new(response.status, response.body)
+        end
+      rescue Faraday::Error => e
+        raise Avalanche::AvaCloud::Error, "Network error: #{e.message}"
+      end
+    end
+  end
+end

data/lib/avalanche/ava_cloud/data/evm/balances.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Avalanche
+  module AvaCloud
+    module Data
+      module EVM
+        # Avalanche Data API provides endpoints for the latest information on avalanche balances.
+        # @see https://developers.avacloud.io/data-api/evm-balances
+        class Balances
+          class << self
+            # Lists ERC-20 token balances of a wallet address.
+            # Balance at a given block can be retrieved with the blockNumber parameter.
+            # Balance for specific contracts can be retrieved with the contractAddresses parameter.
+            # @see https://developers.avacloud.io/data-api/evm-balances/list-erc-20-balances
+            # @param address [String]
+            # @return [Array<Hash{Symbol->Object}>]
+            def erc20_balances(address = nil)
+              DataApi.instance.get("/v1/chains/#{Avalanche::AvaCloud.config.chain_id}/addresses/#{address}/balances:listErc20")
+            end
+
+            # Lists ERC-721 token balances of a wallet address.
+            # Balance at a given block can be retrieved with the blockNumber parameter.
+            # Balance for specific contracts can be retrieved with the contractAddresses parameter.
+            # @see https://developers.avacloud.io/data-api/evm-balances/list-erc-721-balances
+            # @param address [String]
+            # @return [Array<Hash{Symbol->Object}>]
+            def erc721_balances(address = nil)
+              DataApi.instance.get("/v1/chains/#{Avalanche::AvaCloud.config.chain_id}/addresses/#{address}/balances:listErc721")
+            end
+
+            # Lists ERC-1155 token balances of a wallet address.
+            # Balance at a given block can be retrieved with the blockNumber parameter.
+            # Balance for specific contracts can be retrieved with the contractAddresses parameter.
+            # @see https://developers.avacloud.io/data-api/evm-balances/list-erc-1155-balances
+            # @param address [String]
+            # @return [Array<Hash{Symbol->Object}>]
+            def erc1155_balances(address = nil)
+              DataApi.instance.get("/v1/chains/#{Avalanche::AvaCloud.config.chain_id}/addresses/#{address}/balances:listErc1155")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avalanche/ava_cloud/data/evm/blocks.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Avalanche
+  module AvaCloud
+    module Data
+      module EVM
+        # Avalanche Data API provides endpoints for the latest information on avalanche blocks.
+        # @see https://developers.avacloud.io/data-api/evm-blocks
+        class Blocks
+          class << self
+            # Lists the latest indexed blocks on the EVM-compatible chain sorted in descending order by block timestamp.
+            # @see https://developers.avacloud.io/data-api/evm-blocks/list-latest-blocks
+            # @return [Array<Hash{Symbol->Object}>]
+            def blocks
+              DataApi.instance.get("/v1/chains/#{Avalanche::AvaCloud.config.chain_id}/blocks")
+            end
+
+            # Gets the details of an individual block on the EVM-compatible chain.
+            # @see https://developers.avacloud.io/data-api/evm-blocks/get-block
+            # @param block_id [String]
+            # @return [Hash{Symbol->Object}]
+            def block(block_id = nil)
+              DataApi.instance.get("/v1/chains/#{Avalanche::AvaCloud.config.chain_id}/blocks/#{block_id}")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avalanche/ava_cloud/data/evm/chains.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Avalanche
+  module AvaCloud
+    module Data
+      module EVM
+        # Avalanche Data API provides endpoints for the latest information on avalanche chains.
+        # @see https://developers.avacloud.io/data-api/evm-chains
+        class Chains
+          class << self
+            # Lists the AvaCloud supported EVM-compatible chains. Filterable by network.
+            # @see https://developers.avacloud.io/data-api/evm-chains/list-chains
+            # @return [Array<Hash{Symbol->Object}>]
+            def chains
+              DataApi.instance.get("/v1/chains")
+            end
+
+            # Gets chain information for the EVM-compatible chain if supported by AvaCloud.
+            # @see https://developers.avacloud.io/data-api/evm-chains/get-chain-information
+            # @param chain_id [String]
+            # @return [Hash{Symbol->Object}]
+            def chain(chain_id = nil)
+              DataApi.instance.get("/v1/chains/#{chain_id || Avalanche::AvaCloud.config.chain_id}")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avalanche/ava_cloud/data/evm/contracts.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Avalanche
+  module AvaCloud
+    module Data
+      module EVM
+        # Avalanche Data API provides endpoints for the latest information on avalanche contracts.
+        # @see https://developers.avacloud.io/data-api/evm-contracts
+        class Contracts
+          class << self
+            # Gets metadata about the contract at the given address.
+            # @see https://developers.avacloud.io/data-api/evm-contracts/get-contract-metadata
+            # @return [Array<Hash{Symbol->Object}>]
+            def contract_metadata(address = nil)
+              DataApi.instance.get("/v1/chains/#{Avalanche::AvaCloud.config.chain_id}/addresses/#{address}")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avalanche/ava_cloud/data/evm/nfts.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Avalanche
+  module AvaCloud
+    module Data
+      module EVM
+        # Avalanche Data API provides endpoints for the latest information on avalanche NFTs.
+        # @see https://developers.avacloud.io/data-api/nfts
+        class Nfts
+          class << self
+            # Triggers reindexing of token metadata for an NFT token.
+            # Reindexing can only be called once per hour for each NFT token.
+            # @see https://developers.avacloud.io/data-api/nfts/reindex-nft-metadata
+            # @param address [String]
+            # @param token_id [String]
+            # @return [Array<Hash{Symbol->Object}>]
+            def reindexing_token(address = nil, token_id = nil)
+              DataApi.instance.get("/v1/chains/#{Avalanche::AvaCloud.config.chain_id}/nfts/collections/#{address}/tokens/#{token_id}:reindex")
+            end
+
+            # Lists tokens for an NFT contract.
+            # @see https://developers.avacloud.io/data-api/nfts/list-tokens
+            # @param address [String]
+            # @return [Array<Hash{Symbol->Object}>]
+            def tokens(address = nil)
+              DataApi.instance.get("/v1/chains/#{Avalanche::AvaCloud.config.chain_id}/nfts/collections/#{address}/tokens")
+            end
+
+            # Gets token details for a specific token of an NFT contract.
+            # @see https://developers.avacloud.io/data-api/nfts/get-token-details
+            # @param address [String]
+            # @param token_id [String]
+            # @return [Array<Hash{Symbol->Object}>]
+            def token(address = nil, token_id = nil)
+              DataApi.instance.get("/v1/chains/#{Avalanche::AvaCloud.config.chain_id}/nfts/collections/#{address}/tokens/#{token_id}")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avalanche/ava_cloud/data/evm/transactions.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+module Avalanche
+  module AvaCloud
+    module Data
+      module EVM
+        # Avalanche Data API provides endpoints for the latest information on avalanche transactions.
+        # @see https://developers.avacloud.io/data-api/evm-transactions
+        class Transactions
+          class << self
+            # If the address is a smart contract, returns the transaction in which it was deployed.
+            # @see https://developers.avacloud.io/data-api/evm-transactions/get-deployment-transaction
+            # @return [Array<Hash{Symbol->Object}>]
+            def deployment_transactions(address = nil)
+              DataApi.instance.get("/v1/chains/#{Avalanche::AvaCloud.config.chain_id}/contracts/#{address}/transactions:getDeployment")
+            end
+
+            # Lists all contracts deployed by the given address.
+            # @see https://developers.avacloud.io/data-api/evm-transactions/list-deployed-contracts
+            # @param address [String]
+            # @return [Hash{Symbol->Object}]
+            def contract_deployment_transactions(address = nil)
+              DataApi.instance.get("v1/chains/#{Avalanche::AvaCloud.config.chain_id}/contracts/#{address}/deployments")
+            end
+
+            # Returns a list of transactions where the given wallet address had an on-chain interaction
+            # for the given chain. The ERC-20 transfers, ERC-721 transfers, ERC-1155, and internal transactions returned
+            # are only those where the input address had an interaction. Specifically, those lists only include entries
+            # where the input address was the sender (from field) or the receiver (to field) for the sub-transaction.
+            # Therefore the transactions returned from this list may not be complete representations of the on-chain
+            # data. For a complete view of a transaction use the
+            # @see https://developers.avacloud.io/data-api/evm-transactions/list-transactions
+            # @param address [String]
+            # @return [Hash{Symbol->Object}]
+            def transactions(address = nil)
+              DataApi.instance.get("/v1/chains/#{Avalanche::AvaCloud.config.chain_id}/addresses/#{address}/transactions")
+            end
+
+            # Lists native transactions for an address.
+            # @see https://developers.avacloud.io/data-api/evm-transactions/list-native-transactions
+            # @param address [String]
+            # @return [Hash{Symbol->Object}]
+            def native_transactions(address = nil)
+              DataApi.instance.get("/v1/chains/#{Avalanche::AvaCloud.config.chain_id}/addresses/#{address}/transactions:listNative")
+            end
+
+            # Lists ERC-20 transfers for an address.
+            # @see https://developers.avacloud.io/data-api/evm-transactions/list-erc-20-transfers
+            # @param address [String]
+            # @return [Hash{Symbol->Object}]
+            def erc20_transactions(address = nil)
+              DataApi.instance.get("/v1/chains/#{Avalanche::AvaCloud.config.chain_id}/addresses/#{address}transactions:listErc20")
+            end
+
+            # Lists ERC-721 transfers for an address.
+            # @see https://developers.avacloud.io/data-api/evm-transactions/list-erc-721-transfers
+            # @param address [String]
+            # @return [Hash{Symbol->Object}]
+            def erc721_transactions(address = nil)
+              DataApi.instance.get("/v1/chains/#{Avalanche::AvaCloud.config.chain_id}/addresses/#{address}transactions:listErc721")
+            end
+
+            # Lists ERC-1155 transfers for an address.
+            # @see https://developers.avacloud.io/data-api/evm-transactions/list-erc-1155-transfers
+            # @param address [String]
+            # @return [Hash{Symbol->Object}]
+            def erc1155_transactions(address = nil)
+              DataApi.instance.get("/v1/chains/#{Avalanche::AvaCloud.config.chain_id}/addresses/#{address}transactions:listErc1155")
+            end
+
+            # Returns a list of internal transactions for an address and chain. Filterable by block range.
+            # Note that the internal transactions list only contains CALL or CALLCODE transactions with a non-zero value
+            # and CREATE/CREATE2/CREATE3 transactions. To get a complete list of internal transactions use the
+            # debug_ prefixed RPC methods on an archive node.
+            # @see https://developers.avacloud.io/data-api/evm-transactions/list-internal-transactions
+            # @param address [String]
+            # @return [Hash{Symbol->Object}]
+            def internal_transactions(address = nil)
+              DataApi.instance.get("/v1/chains/#{Avalanche::AvaCloud.config.chain_id}/addresses/#{address}transactions:listInternals")
+            end
+
+            # Gets the details of a single transaction.
+            # @see https://developers.avacloud.io/data-api/evm-transactions/get-transaction
+            # @param tx_hash [String]
+            # @return [Hash{Symbol->Object}]
+            def transaction(tx_hash = nil)
+              DataApi.instance.get("/v1/chains/#{Avalanche::AvaCloud.config.chain_id}/transactions/#{tx_hash}")
+            end
+
+            # Lists the transactions that occurred in a given block.
+            # @see https://developers.avacloud.io/data-api/evm-transactions/list-transactions-for-a-block
+            # @param block_id [String]
+            # @return [Hash{Symbol->Object}]
+            def block_transaction(block_id = nil)
+              DataApi.instance.get("/v1/chains/#{Avalanche::AvaCloud.config.chain_id}/blocks/#{block_id}/transactions")
+            end
+
+            # Lists the latest transactions.
+            # @see https://developers.avacloud.io/data-api/evm-transactions/list-latest-transactions
+            # @return [Hash{Symbol->Object}]
+            def latest_transactions
+              DataApi.instance.get("/v1/chains/#{Avalanche::AvaCloud.config.chain_id}/transactions")
+            end
+
+            # Lists the most recent transactions from all supported EVM-compatible chains.
+            # The results can be filtered based on transaction status.
+            # @see https://developers.avacloud.io/data-api/evm-transactions/list-the-latest-transactions-across-all-supported-evm-chains
+            # @return [Hash{Symbol->Object}]
+            def evms_latest_transactions
+              DataApi.instance.get("/v1/transactions")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avalanche/ava_cloud/data_api.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Avalanche
+  module AvaCloud
+    # https://developers.avacloud.io/data-api/overview
+    class DataApi < AvaCloud::BaseApi
+      BASE_URL_API = "https://glacier-api.avax.network"
+
+      class << self
+        # @return [Api]
+        def instance
+          @instance ||= new
+        end
+      end
+
+      # Method to start a new Data API connection.
+      # @return [Faraday::Connection]
+      def initialize
+        super(url_api: BASE_URL_API, require_auth: true)
+      end
+    end
+  end
+end

data/lib/avalanche/ava_cloud/errors.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Avalanche
+  module AvaCloud
+    # Standard error class.
+    class Error < StandardError; end
+
+    # Configuration error class.
+    class ConfigurationError < Error; end
+
+    # Missing Configuration error class.
+    class MissingConfigurationError < ConfigurationError; end
+
+    # API errors.
+    class APIError < Error
+      attr_reader :status, :body
+
+      # @param status [Integer]
+      # @param body [Hash{Symbol-Object}]
+      # @return [self]
+      def initialize(status, body)
+        @status = status
+        @body = body
+        super("API Error: #{status} - #{body}")
+      end
+    end
+
+    # Authentication errors.
+    class AuthenticationError < APIError; end
+
+    # Not found errors.
+    class NotFoundError < APIError; end
+
+    # Server errors.
+    class ServerError < APIError; end
+
+    # Bad Request errors.
+    class BadRequestError < APIError; end
+
+    # Unauthorized errors.
+    class UnauthorizedError < APIError; end
+  end
+end

data/lib/avalanche/ava_cloud/metrics/chains.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Avalanche
+  module AvaCloud
+    class Metrics
+      # Avalanche Data API provides endpoints for the latest information on avalanche chains.
+      # @see https://developers.avacloud.io/data-api/evm-chains
+      class Chains
+        class << self
+          # Get a list of Metrics API supported blockchains.
+          # @see https://developers.avacloud.io/metrics-api/evm-chains/get-a-list-of-supported-blockchains
+          # @return [Array<Hash{Symbol->Object}>]
+          def chains
+            MetricsApi.instance.get("/v2/chains")
+          end
+
+          # Get chain information for Metrics API supported blockchain.
+          # @see https://developers.avacloud.io/metrics-api/evm-chains/get-chain-information-for-supported-blockchain
+          # @param chain_id [String]
+          # @return [Hash{Symbol->Object}]
+          def chain(chain_id = nil)
+            MetricsApi.instance.get("/v2/chains/#{chain_id || Avalanche::AvaCloud.config.chain_id}")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avalanche/ava_cloud/metrics_api.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Avalanche
+  module AvaCloud
+    # https://developers.avacloud.io/metrics-api/overview
+    class MetricsApi < AvaCloud::BaseApi
+      BASE_URL_API = "https://metrics.avax.network"
+
+      class << self
+        # @return [Api]
+        def instance
+          @instance ||= new
+        end
+      end
+
+      # Method to start a new Metric API connection.
+      # @return [Faraday::Connection]
+      def initialize
+        super(url_api: BASE_URL_API, require_auth: false)
+      end
+    end
+  end
+end

data/lib/avalanche/ava_cloud/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Avalanche
+  module AvaCloud
+    VERSION = "0.1.0"
+  end
+end

data/lib/avalanche/ava_cloud/webhook_api.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Avalanche
+  module AvaCloud
+    # https://developers.avacloud.io/webhooks-api/overview
+    class WebhookApi < AvaCloud::BaseApi
+      BASE_URL_API = "https://glacier-api.avax.network"
+
+      class << self
+        # @return [Api]
+        def instance
+          @instance ||= new
+        end
+      end
+
+      # Method to start a new Webhook API connection.
+      # @return [Faraday::Connection]
+      def initialize
+        super(url_api: BASE_URL_API, require_auth: true)
+      end
+    end
+  end
+end

data/lib/avalanche/ava_cloud/webhooks/webhooks.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Avalanche
+  module AvaCloud
+    class Webhooks
+      # Avalanche Data API provides endpoints for the latest information on avalanche webhook.
+      # @see https://developers.avacloud.io/webhooks-api/webhooks
+      class Webhook
+        class << self
+          # Lists webhooks for the user.
+          # @see https://developers.avacloud.io/webhooks-api/webhooks/list-webhooks
+          # @return [Array<Hash{Symbol->Object}>]
+          def lists
+            WebhookApi.instance.get("/v1/webhooks")
+          end
+
+          # Lists webhooks for the user.
+          # @see https://developers.avacloud.io/webhooks-api/webhooks/create-a-webhook
+          # @return [Array<Hash{Symbol->Object}>]
+          def create(params)
+            WebhookApi.instance.post("/v1/webhooks", params)
+          end
+
+          # Retrieves a webhook by ID.
+          # @see https://developers.avacloud.io/webhooks-api/webhooks/get-a-webhook-by-id
+          # @return [Array<Hash{Symbol->Object}>]
+          def retrieve(id = nil)
+            WebhookApi.instance.post("/v1/webhooks/#{id}")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/avalanche/ava_cloud.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require "dry-configurable"
+
+# Base ava cloud lib class
+require_relative "ava_cloud/version"
+require_relative "ava_cloud/errors"
+require_relative "ava_cloud/base_api"
+
+# AvaCloud Data API
+require_relative "ava_cloud/data_api"
+require_relative "ava_cloud/data/evm/balances"
+require_relative "ava_cloud/data/evm/blocks"
+require_relative "ava_cloud/data/evm/chains"
+require_relative "ava_cloud/data/evm/contracts"
+require_relative "ava_cloud/data/evm/nfts"
+require_relative "ava_cloud/data/evm/transactions"
+
+# AvaCloud Metrics API
+require_relative "ava_cloud/metrics_api"
+require_relative "ava_cloud/metrics/chains"
+
+# AvaCloud Webhook API
+require_relative "ava_cloud/webhook_api"
+require_relative "ava_cloud/webhooks/webhooks"
+
+module Avalanche
+  # @example Configure AvaCloud
+  # Avalanche::AvaCloud.configure do |config|
+  #   config.api_key = "your_api_key"
+  #   config.network = "mainet"
+  #   config.chain_id = "5207418"
+  # end
+  module AvaCloud
+    extend Dry::Configurable
+
+    setting :api_key, default: nil
+    setting :network, default: nil
+    setting :chain_id, default: nil
+  end
+end

data/lib/avalanche.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require_relative "avalanche/ava_cloud"
+
+# Avalanche gem
+module Avalanche
+end

data/sig/avalanche.rbs

@@ -0,0 +1,4 @@
+module Avalanche
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,126 @@
+--- !ruby/object:Gem::Specification
+name: avalanche
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Andres Yebra
+autorequire: avalanche
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: dry-configurable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday-retry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A Ruby SDK to interact with Avalanche's primary network, Avalanche L1s,
+  and Ethereum.
+email:
+- andres@even.biz
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/avalanche.rb
+- lib/avalanche/ava_cloud.rb
+- lib/avalanche/ava_cloud/base_api.rb
+- lib/avalanche/ava_cloud/data/evm/balances.rb
+- lib/avalanche/ava_cloud/data/evm/blocks.rb
+- lib/avalanche/ava_cloud/data/evm/chains.rb
+- lib/avalanche/ava_cloud/data/evm/contracts.rb
+- lib/avalanche/ava_cloud/data/evm/nfts.rb
+- lib/avalanche/ava_cloud/data/evm/transactions.rb
+- lib/avalanche/ava_cloud/data_api.rb
+- lib/avalanche/ava_cloud/errors.rb
+- lib/avalanche/ava_cloud/metrics/chains.rb
+- lib/avalanche/ava_cloud/metrics_api.rb
+- lib/avalanche/ava_cloud/version.rb
+- lib/avalanche/ava_cloud/webhook_api.rb
+- lib/avalanche/ava_cloud/webhooks/webhooks.rb
+- sig/avalanche.rbs
+homepage: https://github.com/even-labs/avalanche
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/even-labs/avalanche
+  source_code_uri: https://github.com/even-labs/avalanche
+  changelog_uri: https://github.com/even-labs/avalanche/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.7
+specification_version: 4
+summary: Ruby SDK for Avalanche
+test_files: []