Kipt
Kipt is leveraging the simplicity of Lua scripts to manage Starknet contracts using starknet-rs under the hood. With few lines, you can declare, deploy, invoke and call contracts.
The main focus of Kipt is to be used in the CI, without the need to write bash script using Cast from Starknet Foundry or Starkli.
Under the hood, Kipt is using starknet-rs to interact with Starknet.
Please take 5 min to read the book here, it's short and very helpful to get started!
Lua, an other language to learn?
You don't know Lua? No problem at all, it's a very small and easy scripting language, beginner guide here and full documentation here. And to use Kipt, you only need to know very few element of the language.
If you prefer a short cheatsheet, go here or here.
(For those who have already written an add-on for a famous MMO, welcome home!)
Quick start
To test Kipt, the easiest way is:
- Install Kipt
# 1. Install
curl https://raw.githubusercontent.com/glihm/kipt/main/kiptup/install | sh
source ~/.bashrc
kiptup
- Create a simple "demo.lua" script copying the example below, replacing with the name of your contract.
- Spin up katana in an other terminal.
- Run
kipt --lua ./demo.lua.
Example
RPC = "KATANA"
ACCOUNT_ADDRESS = "0x517ececd29116499f4a1b64b094da79ba08dfd54a3edaa316134c41f8160973"
ACCOUNT_PRIVKEY = "0x1800000000300000180000000000030000000000003006001800006600"
-- No args -> kipt.out
local logger = logger_init()
local decl_res, err = declare(
"mycontract",
{ watch_interval = 300, artifacts_path = "./target/dev" }
)
if err then
print(err)
os.exit(1)
end
print("Declared class_hash: " .. decl_res.class_hash)
-- Deploy with no constructor args.
local depl_res, err = deploy(decl_res.class_hash, {}, { watch_interval = 300, salt = "0x1234" })
if err then
print(err)
os.exit(2)
end
local contract_address = depl_res.deployed_address
print("Contract deployed at: " .. contract_address)
-- Invoke to set a value.
local invk_res, err = invoke(
{
{
to = contract_address,
func = "set_a",
calldata = { "0x1234" },
},
},
{ watch_interval = 300 }
)
if err then
print(err)
os.exit(3)
end
print("Invoke TX hash: " .. invk_res.tx_hash)
local call_res, err = call(contract_address, "get_a", {}, {})
print_str_array(call_res)
7 Jul 11, 2023
138 Apr 22, 2023
22 Jun 2, 2023
9 Sep 11, 2023
149 Aug 1, 2023
2 Dec 20, 2022
3 Dec 21, 2022
270 Jan 5, 2023
4 Oct 6, 2022
653 Dec 26, 2022
1 May 2, 2022
36 Dec 17, 2022
4 Aug 23, 2022
7 Jan 9, 2023
3 Oct 22, 2022
4 Nov 18, 2022
50 Jan 4, 2023