# Getting Started

## Installation

```solidity
# use the main branch

npm install starknet

# to use latest features (merges in develop branch)

npm install starknet@next
```

## Running test locally

### With Devnet

Example devnet version is `0.7.1`.

Get devnet with docker:

```bash
docker pull shardlabs/starknet-devnet:0.7.1
docker run -p 5050:5050 shardlabs/starknet-devnet:0.7.1 --seed 0
```

Open new console tab, go to your starknet.js directory and run:

```bash
npm run test # all tests
npm run test ./__tests__/contract.test.ts # just one test suite
```

By default `defaultProvider` tests will be ran through the `Sequencer`.

If you want to run `defaultProvider` through the `RPC` run:

```bash
export TEST_RPC_URL = "http://127.0.0.1:5050/rpc"# only RPC related tests:
npm run test ./__tests__/rpcProvider.test.ts
```

## Compiling StarkNet Contracts

Please check the StarkNet documentation [here](https://www.cairo-lang.org/docs/hello_starknet/intro.html) to compile starknet contracts.

Additional helpful resources can also be found at [OpenZeppelin](https://docs.openzeppelin.com/contracts-cairo/0.5.0/) documentation site.

Get the class hash of a contract: [starkli](https://github.com/xJonathanLEI/starkli).

## Full example with account & erc20 deployments

Please take a look at our workshop using OpenZeppelin contracts [here](https://github.com/0xs34n/starknet.js-workshop).

Example with Argent contract [here](https://github.com/0xs34n/starknet.js-account).

Newton

How do I get started with starknetjs?

How do I put funds into my newly created account from the ape console?


ApeWorX: How do I fund newly created accounts from the ape console?

How to use Access Control in Cairo securely? What library can I use for implementing it?

How to use Access Control in Cairo language securely?

Hi ! Is there something going on the testnet? The block time remains the same, but I have to wait several dozen minutes for my transactions to be accepted

And so, most of the time, the gas price changes a lot between the moment I send the transaction, and its execution, thus I'm getting the `Actual fee exceeded max fee` error quite often

_This question was originally posted on [StarkNet Discord](https://www.newton.so/view?tags=discord)_

Is there something going on the testnet StarkNet?

Bumped into rc_bound today and was wondering: where/how is it defined and why is it much smaller than the field prime?

Cairo: Where/how is it defined and why is it much smaller than the field prime?

Hi team. How can I use start_prank with deploy_contract? Since get_caller_address() works in constructor now, I need a way in protostar to set caller address without having contract address. May be a 'caller' argument in deploy_contract cheatcode works best.

_This question was originally posted on [StarkNet Discord](https://www.newton.so/view?tags=discord)_

How can I use start_prank with deploy_contract? 

![img](https://sun9-13.userapi.com/impg/9YrwMdCKAVbgBRKmMdGysFrP3qhbHWBiTNgp3A/64s3EVNAEpE.jpg?size=1158x874&quality=96&sign=f55c859f079b65212bc744b47e7bb7af&type=album)
Is there a plan to get better visibility when a transaction got received but not placed into a block?
For the moment we only know that it is RECEIVED but have no clue if it’s been discarded because of missing constructor params or if it’s just late:

```python
{
	transaction_hash: '0x3d26af3d7a8f17ea28c2a71a250fd8c5dcd162b779051fd36a3bfcd9f130fab',
	actual_fee: undefined,
	status: 'RECEIVED',
	status_data: undefined,
	messages_sent: [],
	events: [],
	l1_origin_message: undefined
}
```

upd: I noticed we are notified when we make an error, but:

1. we don’t know what’s happening between `RECEIVED` and `REJECTED | ACCEPTED_ON_L2`, it’d be nice to be able to monitor a bit more preceisely where’s the transaction in the pipeline

2. the error message is often cryptic and not human readable, ex:

```python
Error: REJECTED: TRANSACTION_FAILED
Error at pc=0:1073:
An ASSERT_EQ instruction failed: 9:6 != 9:5.
```

Is there a way / tool to be able to debug this kind of failed transactions?

A plan to get better visibility when a transaction got received but not placed into a block?

What’s the difference between Account Abstraction (AA) and Externally Owned Accounts (EOA)?

---

This question is participating in [Newton Bounties | Incentivized Test Program](https://www.notion.so/Newton-Bounties-Incentivized-Test-Program-94322ad48e7d40a3adcf36f6b26174cd) Every verified valid question gets $10 USDC (mainnet)

Popular tags

How do I get started with starknetjs?

1 answers

Getting Started

Installation

Running test locally

With Devnet

Compiling StarkNet Contracts

Full example with account & erc20 deployments

Your answer

Related

You may find useful