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.
yarn add @range-security/range-sdkHere's a basic example to get you started:
// Range Implementation of `new-contract-code-stored` alert rule
import {
RangeSDK,
OnBlock,
IRangeBlock,
IRangeAlertRule,
ISubEvent,
} from '@range-security/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,
});
// Running the RangeSDK instance
await range.init({
onBlock: myOnBlock,
});
})();// Range Implementation of `rpc-status` alert rule
import {
RangeSDK,
OnTick,
IRangeAlertRule,
ISubEvent,
} from '@range-security/range-sdk';
// Define your OnTick handler
const myOnTick: OnTick = {
callback: async (
timestamp: string,
rule: IRangeAlertRule,
): Promise<ISubEvent[]> => {
const parameters = rule.parameters;
// note: if p.ticker is set as 10, the rule will run on each 10 minutes
if (dayjs(timestamp).get('minute') % p.ticker !== 0) {
return [];
}
try {
await axios.get(`https://rpc.osmosis.zone/status`);
return [];
} catch (error) {
return [
{
details: {
message: `Osmosis public RPC is down: ${JSON.stringify(error).slice(0, 100)}...`,
},
txHash: '',
addressesInvolved: [],
caption: 'Osmosis public RPC down',
},
];
}
},
};
(async () => {
// Defining the RangeSDK instance
const range = new RangeSDK({
token: env.RANGE_TOKEN,
});
// Running the RangeSDK instance
await range.init({
onTick: myOnTick,
});
})();For more examples and use-cases, see the open-source rule repositories of several Cosmos chains:
- 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:
- Fork the repository.
- Clone your forked repository and install dependencies:
git clone https://github.com/your-username/range-sdk.git
cd range-sdk
npm install- Make your changes, add tests, and ensure tests pass.
- Commit your changes and push to your fork.
- 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!