Range SDK is a powerful Typescript library that simplifies the development of security rules and anomaly detectors for Cosmos blockchains. With the Range SDK, developers can easily extend the security of their protocols, monitoring in real-time the validity of invariants, risk scenarios, phishing attacks, spam, and much more.

• Range SDK
  • Table of Contents
  • Installation
  • Usage
  • Features
  • Documentation
  • How To Contribute
  • Reporting bugs
  • License
  • Credits

yarn add @rangesecurity/range-sdk

Here's a basic example to get you started:

// Range Implementation of `new-contract-code-stored` alert rule
import { RangeSDK } from '@rangesecurity/range-sdk';

// Define your OnBlock handler
const myOnBlock: OnBlock = {
  callback: async (
    block: IRangeBlock,
    rule: IRangeAlertRule,
  ): Promise<ISubEvent[]> => {
    const allMessages = block.transactions.flatMap((tx) => tx.messages);
    const targetMessages = allMessages.filter((m) => {
      return m.type === 'cosmwasm.wasm.v1.MsgStoreCode';
    });

    const results = targetMessages.map((m) => ({
      details: {
        message: `New CW contract code stored by ${m.value.sender}`,
      },
      txHash: m.hash,
      addressesInvolved: m.addresses,
    }));

    return results;
  },
};

(async () => {
    // Defining the RangeSDK instance
    const range = new RangeSDK({
      token: env.RANGE_TOKEN,
      onBlock: myOnBlock,
    });

    // Running the RangeSDK instance
    await range.init();
})();

For more examples and use-cases, see the open-source rule repositories of several Cosmos chains:

• Osmosis Range Rules
• Cosmos Hub Range Rules

• Simple and intuitive API
• Advanced security rule building in Typescript
• Easy integration testing with real block data
• Powerful anomaly detection examples
• Integration with most Cosmos chains
• Extensive documentation

Complete documentation can be found at our official documentation site.

We welcome contributions from the community! To get started:

1. Fork the repository.
2. Clone your forked repository and install dependencies:

git clone https://github.com/your-username/range-sdk.git
cd range-sdk
npm install

3. Make your changes, add tests, and ensure tests pass.
4. Commit your changes and push to your fork.
5. Create a pull request with a detailed explanation of your changes.

Before contributing, please read our CONTRIBUTING.md.

If you encounter any bugs or issues, please open an issue on GitHub. When reporting a bug, please provide as much context as possible, including error messages, logs, and steps to reproduce the bug.

This project is licensed under the MIT License. See the LICENSE file for details.

Thank you to all the contributors who have helped make Range SDK what it is today!