asimov-near-module 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7d49c00c509956e971cba5e6632d34734f6f0728c9e1ad89a94842d784624c82
+  data.tar.gz: 5bd9451bdb4a365eb0acff22e79058e48b79b25bcca62caceb11de5654566f89
+SHA512:
+  metadata.gz: 8dff6dceac9b0f80d0ca19e983e5a759272453b2dc42d29be9b6db93002a47221234b7d8890829ceaeb86d4eec8e26f4ca99a434d60e27bc336ab98948f5f724
+  data.tar.gz: aecea5307e2b9e021930492e2ffc365195b168194394aca06934afb44f64da631508b19ba5f09673b0145eced0df994274142ae88c452284979d6b7fc8f5f714

data/AUTHORS

@@ -0,0 +1 @@
+* Arto Bendiken <arto@asimov.so>

data/CHANGES.md

@@ -0,0 +1,12 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## 0.0.1 - 2025-05-29
+### Added
+- Import structured data from NEAR Protocol blocks and transactions
+- Support both the mainnet and testnet environments
+- Collect the raw JSON data via the edge-cached neardata.xyz API

data/README.md

@@ -0,0 +1,96 @@
+# ASIMOV NEAR Module
+
+[![License](https://img.shields.io/badge/license-Public%20Domain-blue.svg)](https://unlicense.org)
+[![Package on Crates.io](https://img.shields.io/crates/v/asimov-near-module.svg)](https://crates.io/crates/asimov-near-module)
+[![Package on PyPI](https://img.shields.io/pypi/v/asimov-near-module.svg)](https://pypi.org/project/asimov-near-module)
+[![Package on RubyGems](https://img.shields.io/gem/v/asimov-near-module.svg)](https://rubygems.org/gems/asimov-near-module)
+[![Package on NPM](https://img.shields.io/npm/v/asimov-near-module.svg)](https://npmjs.com/package/asimov-near-module)
+
+[ASIMOV] module for data import from the [NEAR Protocol] blockchain network.
+
+## ✨ Features
+
+- Imports structured data from [NEAR Protocol] blocks and transactions.
+- Supports both the [mainnet] and [testnet] environments.
+- Collects the raw JSON data via the edge-cached [neardata.xyz] API.
+- Constructs a semantic knowledge graph based on the [KNOW] ontology.
+- Supports plain JSON output as well as [RDF] output in the form of [JSON-LD].
+- Distributed as a standalone static binary with zero runtime dependencies.
+
+## 🛠️ Prerequisites
+
+- [Rust] 1.85+ (2024 edition) if building from source code
+
+## ⬇️ Installation
+
+### Installation from PyPI
+
+```bash
+pip install -U asimov-near-module
+```
+
+### Installation from RubyGems
+
+```bash
+gem install asimov-near-module
+```
+
+### Installation from NPM
+
+```bash
+npm install -g asimov-near-module
+```
+
+### Installation from Source Code
+
+```bash
+cargo install asimov-near-module
+```
+
+## 👉 Examples
+
+### Fetching Testnet Blocks
+
+```bash
+asimov-near-fetcher near://testnet/100000000
+```
+
+### Fetching Mainnet Blocks
+
+```bash
+asimov-near-fetcher near://mainnet/100000000
+```
+
+## 📚 Reference
+
+### Installed Binaries
+
+- `asimov-near-fetcher`: collects JSON data from the [neardata.xyz] API
+- `asimov-near-importer`: collects and transforms JSON into JSON-LD (TBD)
+
+## 👨‍💻 Development
+
+```bash
+git clone https://github.com/asimov-modules/asimov-near-module.git
+```
+
+---
+
+[![Share on X](https://img.shields.io/badge/share%20on-x-03A9F4?logo=x)](https://x.com/intent/post?url=https://github.com/asimov-modules/asimov-near-module&text=asimov-near-module)
+[![Share on Reddit](https://img.shields.io/badge/share%20on-reddit-red?logo=reddit)](https://reddit.com/submit?url=https://github.com/asimov-modules/asimov-near-module&title=asimov-near-module)
+[![Share on Hacker News](https://img.shields.io/badge/share%20on-hn-orange?logo=ycombinator)](https://news.ycombinator.com/submitlink?u=https://github.com/asimov-modules/asimov-near-module&t=asimov-near-module)
+[![Share on Facebook](https://img.shields.io/badge/share%20on-fb-1976D2?logo=facebook)](https://www.facebook.com/sharer/sharer.php?u=https://github.com/asimov-modules/asimov-near-module)
+[![Share on LinkedIn](https://img.shields.io/badge/share%20on-linkedin-3949AB?logo=linkedin)](https://www.linkedin.com/sharing/share-offsite/?url=https://github.com/asimov-modules/asimov-near-module)
+
+[ASIMOV]: https://github.com/asimov-platform
+[JSON-LD]: https://json-ld.org
+[KNOW]: https://github.com/know-ontology
+[NEAR Protocol]: https://near.org
+[NPM]: https:/npmjs.org
+[Python]: https://python.org
+[RDF]: https://www.w3.org/TR/rdf12-concepts/
+[Ruby]: https://ruby-lang.org
+[Rust]: https://rust-lang.org
+[mainnet]: https://docs.near.org/protocol/network/networks#mainnet
+[neardata.xyz]: https://neardata.xyz
+[testnet]: https://docs.near.org/protocol/network/networks#testnet

data/UNLICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+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 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.
+
+For more information, please refer to <https://unlicense.org/>

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/bin/asimov-near-fetcher

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+require_relative "../lib/asimov-near-module"
+argv0 = ::ASIMOV_Near_Module::Fetcher.path or abort("asimov-near-fetcher not found")
+if ::Gem.win_platform?
+  ::Kernel.exit(::Kernel.system(argv0, *ARGV) ? 0 : $?.exitstatus)
+else
+  ::Kernel.exec(argv0, *ARGV)
+end

data/lib/asimov-near-module/fetcher.rb

@@ -0,0 +1,38 @@
+# This is free and unencumbered software released into the public domain.
+
+module ASIMOV_Near_Module; end
+
+class ASIMOV_Near_Module::Fetcher
+  def self.path
+    self.which("asimov-near-fetcher")
+  end
+
+  def self.execute(...)
+    self.new(...).execute
+  end
+
+  def initialize(*args, env: {})
+    @argv0 = self.class.path.freeze
+    @args = args.map(&:to_s).freeze
+    @env = env.to_h.freeze
+  end
+
+  def execute(*args)
+    ::Kernel.system(@env, @argv0, *(@args + args.map(&:to_s))) ? 0 : $?.exitstatus
+  end
+
+  protected
+
+  def self.which(command)
+    gem_bindir = ::Gem.bindir
+    exts = ENV['PATHEXT'] ? ENV['PATHEXT'].split(';') : ['']
+    ENV['PATH'].split(::File::PATH_SEPARATOR).each do |dir|
+      next if dir == gem_bindir  # avoid infinite recursion
+      exts.each do |ext|
+        exe = ::File.join(dir, "#{command}#{ext}")
+        return exe if ::File.executable?(exe) && !::File.directory?(exe)
+      end
+    end
+    nil  # not found
+  end
+end

data/lib/asimov-near-module.rb

@@ -0,0 +1,7 @@
+# This is free and unencumbered software released into the public domain.
+
+module ASIMOV_Near_Module
+  VERSION = "0.0.1".freeze
+end
+
+require_relative 'asimov-near-module/fetcher'

metadata

@@ -0,0 +1,53 @@
+--- !ruby/object:Gem::Specification
+name: asimov-near-module
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- ASIMOV Protocol
+bindir: bin
+cert_chain: []
+date: 2025-05-29 00:00:00.000000000 Z
+dependencies: []
+description: ASIMOV module for data import from the NEAR Protocol blockchain network.
+email: support@asimov.so
+executables:
+- asimov-near-fetcher
+extensions: []
+extra_rdoc_files: []
+files:
+- AUTHORS
+- CHANGES.md
+- README.md
+- UNLICENSE
+- VERSION
+- bin/asimov-near-fetcher
+- lib/asimov-near-module.rb
+- lib/asimov-near-module/fetcher.rb
+homepage: https://github.com/asimov-modules
+licenses:
+- Unlicense
+metadata:
+  homepage_uri: https://github.com/asimov-modules
+  source_code_uri: https://github.com/asimov-modules/asimov-near-module
+  changelog_uri: https://github.com/asimov-modules/asimov-near-module/blob/master/CHANGES.md
+  bug_tracker_uri: https://github.com/asimov-modules/asimov-near-module/issues
+  documentation_uri: https://github.com/asimov-modules/asimov-near-module/blob/master/README.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: ASIMOV module for data import from the NEAR Protocol blockchain network.
+test_files: []