@safer-sh/core NPM

@safer-sh/core

Core logic module for Safer - a minimal Ethereum Safe multi-signature wallet client.

⚠️ Disclaimer ⚠️
This tool is NOT intended for production environments or for managing significant funds.

Overview

The @safer-sh/core module provides the essential functionality for interacting with Safe multi-signature wallets on Ethereum networks. It's designed with minimal dependencies and a focus on supply chain attack risk mitigation.

This package implements the core logic needed to:

Create and manage Safe wallets
Generate and sign transactions
Handle owner management operations
Interact with Safe contracts

Installation

npm install @safer-sh/core

Usage

const { services } = require('@safer-sh/core');
const { ethers } = require('ethers');

// Initialize services with provider
const provider = new ethers.providers.JsonRpcProvider('https://rpc-endpoint.example');

// Get Safe information
const safeInfo = await services.safeService.getSafeInfo({
  safeAddress: '0xYourSafeAddress',
  rpcUrl: 'https://rpc-endpoint.example',
  chainId: 1  // Mainnet
});

// Create ETH transfer transaction
const txData = await services.transactionService.createEthTransferTx({
  safeAddress: '0xYourSafeAddress',
  rpcUrl: 'https://rpc-endpoint.example',
  chainId: 1,
  receiverAddress: '0xRecipientAddress',
  amount: '1.5'  // ETH amount
});

// Sign a transaction
const signedTx = await services.signService.signTransaction({
  safeAddress: '0xYourSafeAddress',
  rpcUrl: 'https://rpc-endpoint.example',
  chainId: 1,
  transaction: txData,
  signer: yourSigner  // Must implement ISaferSigner interface
});

// Execute a transaction
const receipt = await services.executeService.executeTransaction({
  safeAddress: '0xYourSafeAddress',
  rpcUrl: 'https://rpc-endpoint.example',
  chainId: 1,
  transaction: signedTx,
  signer: yourSigner
});