Getting Started

Library to interact with the GEB smart contracts. Manage your safes, mint stablecoins, inspect the system state, and much more.
The library is written in Typescript with full typing support. It allows access to the low level API to directly interact with the contracts.
Install
1
npm install geb.js
Copied!
Dependencies
At the moment, Geb.js requires to use Ether.js V5. In the future we will support Web3.
1
npm install ethers
Copied!
Documentation
Full API documentation is available here.
Examples
This is a complete example of how you can inspect a SAFE and also open a new one using your own proxy:
1
import { ethers, utils as ethersUtils } from 'ethers'
2
import { Geb, utils } from 'geb.js'
3
​
4
// Setup Ether.js
5
const provider = new ethers.providers.JsonRpcProvider(
6
    'http://kovan.infura.io/<API KEY>'
7
)
8
const wallet = new ethers.Wallet('0xdefiisawesome...', provider)
9
​
10
// Create the main GEB object
11
const geb = new Geb('kovan', provider)
12
​
13
// Get a SAFE
14
const safe = await geb.getSafe(4)
15
console.log(`Safe id 4 has: ${utils.wadToFixed(safe.debt).toString()} worth of debt.`)
16
console.log(`It will get liquidated if ETH price falls below ${(await safe.liquidationPrice())?.toString()} USD.`)
17
​
18
// Open a new SAFE, lock ETH and draw system coins in a single transaction using a proxy
19
// Note: Before doing this you need to create your own proxy
20
​
21
// We first need to check that the system didn't reach the debt ceiling so that we can
22
// mint more system coins.
23
const globalDebt = await geb.contracts.safeEngine.globalDebt()
24
const debtCeiling = await geb.contracts.safeEngine.globalDebtCeiling()
25
const systemCoinsToDraw = ethersUtils.parseEther('15')
26
if(globalDebt.add(systemCoinsToDraw).gt(debtCeiling)) {
27
    throw new Error('Debt ceiling too low, not possible to draw this amount of system coins.')
28
}
29
​
30
// We're good to mint some system coins! 
31
const proxy = await geb.getProxyAction(wallet.address)
32
const tx = proxy.openLockETHAndGenerateDebt(
33
    ethersUtils.parseEther('1'), // Lock 1 Ether
34
    utils.ETH_A,                 // Of collateral type ETH_A
35
    systemCoinsToDraw            // And draw 15 system coins
36
)
37
​
38
tx.gasPrice = ethers.BigNumber.from('80').mul('1000000000') // Set the gas price to 80 Gwei
39
const pending = await wallet.sendTransaction(tx) // Send the transaction
40
console.log(`Transaction ${pending.hash} waiting to be mined...`)
41
await pending.wait() // Wait for it to be mined
42
console.log('Transaction mined, safe opened!')
Copied!
Additional examples
In the examples below we assume that variables are defined like in the complete example above.
1.
​Deploy a new proxy​
2.
​Partial repay of safe debt​
3.
​Complete repay of safe debt​
4.
​Withdraw Ether collateral​
5.
​Make direct contract calls​
6.
​Multicall​
Deploy a new proxy
1
const tx = geb.deployProxy()
2
await wallet.sendTransaction(tx)
Copied!
Partial repayment of safe debt
1
const proxy = await geb.getProxyAction("0xdefidream...")
2
​
3
// You first need to approve your proxy to spend your system coins
4
let tx =  geb.contracts.coin.approve(proxy.proxyAddress, ethers.constants.MaxUint256)
5
await wallet.sendTransaction(tx)
6
​
7
// Repay 1 system coin worth of debt for SAFE #4
8
tx = proxy.repayDebt(4, ethersUtils.parseEther('1'))
9
await wallet.sendTransaction(tx)
Copied!
Complete repayment of safe debt
1
const proxy = await geb.getProxyAction("0xdefidream...")
2
​
3
// You first need to approve your proxy to spend your system coins
4
let tx =  geb.contracts.coin.approve(proxy.proxyAddress, ethers.constants.MaxUint256)
5
await wallet.sendTransaction(tx)
6
​
7
// Repay all debt of SAFE #4
8
tx = proxy.repayAllDebt(4)
9
await wallet.sendTransaction(tx)
Copied!
Withdraw Ether collateral
1
const proxy = await geb.getProxyAction("0xdefidream...")
2
// Unlock 1 ETH of collateral from SAFE #4 and transfer it to its owner 
3
const tx = proxy.freeETH(4, ethersUtils.parseEther('1'))
4
await wallet.sendTransaction(tx)
Copied!
Repay all debt and withdraw all collateral
1
const proxy = await geb.getProxyAction("0xdefidream...")
2
const safe = await geb.getSafe(4)
3
​
4
// You first need to approve your proxy to spend your system coins
5
let tx =  geb.contracts.coin.approve(proxy.proxyAddress, ethers.constants.MaxUint256)
6
await wallet.sendTransaction(tx)
7
​
8
// Pay back everything and get your ETH back into your wallet
9
const tx = proxy.repayAllDebtAndFreeETH(4, safe.collateral)
10
await wallet.sendTransaction(tx)
Copied!
Make direct contract calls
Geb.js exposes all contract APIs of all core contracts in the Geb.contracts object. Solidity functions that are read-only (view or pure) return asynchronously the expected value from the chain. State changing functions will return a transaction object to passed to ether.js or web3.
1
// Fetch some system parameters from their respective contracts
2
const surplusBuffer = await geb.contracts.accountingEngine.surplusBuffer()
3
const { stabilityFee } = await geb.contracts.taxCollector.collateralTypes(utils.ETH_A)
4
​
5
// Liquidate a Safe
6
const tx = geb.contracts.liquidationEngine.liquidateSAFE(utils.ETH_A,"0xdefidream...");
7
await wallet.sendTransaction(tx)
Copied!
Multicall
Useful to bundle read-only calls in a single RPC call:
1
const [ globalDebt, collateralInfo ] = await geb.multiCall([
2
    geb.contracts.safeEngine.globalDebt(true), // !! Note the last parameter set to true.
3
    geb.contracts.safeEngine.collateralTypes(utils.ETH_A, true),
4
])
Copied!

Helper Contracts - Previous

SAFE Manager

Next - GEB.js

Global Settlement Guide

Last modified 5mo ago

Copy link

Contents

Partial repayment of safe debt

Complete repayment of safe debt

Withdraw Ether collateral

Repay all debt and withdraw all collateral

Make direct contract calls

Multicall