Skip to content

Commit 96c1787

Browse files
docs: update documentation
1 parent 17920c7 commit 96c1787

10 files changed

+21
-27
lines changed

doc/building-running.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -36,15 +36,15 @@ nix run .#mainnet/node
3636
```
3737

3838
More detailed instructions on GHC, Cabal, libraries and `cardano-node` setup can be found here:
39-
- [Installing Cardano Node from source](https://github.com/IntersectMBO/cardano-node/blob/master/doc/getting-started/install.md)
40-
- [Building Cardano Node with nix](https://github.com/IntersectMBO/cardano-node/blob/master/doc/getting-started/building-the-node-using-nix.md)
39+
- [Installing Cardano Node from source](https://developers.cardano.org/docs/get-started/cardano-node/installing-cardano-node/#building-from-source)
40+
- [Building Cardano Node with nix](https://developers.cardano.org/docs/get-started/cardano-node/installing-cardano-node/#building-via-nix)
4141

4242
### Set up and run the db-sync node
4343

4444
- Install secp256k1 library as a prerequisite for building with cabal:
4545

4646
``` shell
47-
./scripts/secp256k1-setup.sh ac83be33d0956faf6b7f61a60ab524ef7d6a473a
47+
./scripts/secp256k1-setup.sh acf5c55ae6a94e5ca847e07def40427547876101
4848
# Check ./github/workflows/haskell.yml to validate the git sha above.
4949

5050
# On Linux

doc/community-tools.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
#Community tools
1+
# Community tools
22

33
This section provides a list of community-developed tools that integrate with cardano-db-sync. We appreciate the efforts of these developers in expanding the ecosystem. If you have a tool you'd like to add to this list, please open an issue or a pull request.
44

doc/configuration.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -552,7 +552,7 @@ This will effect all governance related data/functionality.
552552
`remove_jsonb_from_schema`
553553

554554
To improve inserting performance you can remove Jsonb data types in the schema. They can be reintroduced by using `disable` or by simply not using all together.
555-
A warning will logw if `remove_jsonb_from_schema` was previously set to `enable` and then either removed from the configuration file or set to `disabled`.
555+
A warning will log if `remove_jsonb_from_schema` was previously set to `enable` and then either removed from the configuration file or set to `disabled`.
556556

557557
* Type: `string`
558558

doc/docker.md

-6
Original file line numberDiff line numberDiff line change
@@ -71,9 +71,6 @@ entrypoint. Possible values are:
7171
* mainnet
7272
* preprod
7373
* preview
74-
* private
75-
* sanchonet
76-
* shelley_qa
7774

7875
#### `POSTGRES_HOST` (required)
7976

@@ -202,9 +199,6 @@ entrypoint. Possible values are:
202199
* mainnet
203200
* preprod
204201
* preview
205-
* private
206-
* sanchonet
207-
* shelley_qa
208202

209203
#### `POSTGRES_HOST` (required)
210204

doc/installing-with-nix.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ build Cardano DB Sync.
99
This guide assumes you have the following tools:
1010

1111
* [Nix](https://nixos.org/download.html)
12-
* [Cardano Node](https://github.com/IntersectMBO/cardano-node/blob/master/doc/getting-started/building-the-node-using-nix.md)
12+
* [Cardano Node](https://developers.cardano.org/docs/get-started/cardano-node/installing-cardano-node/)
1313

1414
Nix will handle all other dependencies.
1515

doc/installing.md

+8-8
Original file line numberDiff line numberDiff line change
@@ -5,15 +5,15 @@
55
This guide assumes you have the following tools:
66

77
* [Git](https://git-scm.com/download)
8-
* [Cardano Node](https://github.com/IntersectMBO/cardano-node/blob/master/doc/getting-started/install.md)
8+
* [Cardano Node](https://developers.cardano.org/docs/get-started/cardano-node/installing-cardano-node/)
99
* [Postgres Development Libraries (libpq)](https://www.postgresql.org/download/)
1010
* [ICU Development Libraries (libicu-dev)](https://unicode-org.github.io/icu/download/)
1111
* [pkg-config](https://www.freedesktop.org/wiki/Software/pkg-config/)
1212

1313
In addition, Cardano DB Sync requires the following software (instructions below):
1414

15-
* [GHC](https://www.haskell.org/ghcup/install/) >= 8.10.7
16-
* [Cabal](https://www.haskell.org/ghcup/install/) >= 3.10.1.0
15+
* [GHC](https://www.haskell.org/ghcup/install/) >= 9.6.7
16+
* [Cabal](https://www.haskell.org/ghcup/install/) >= 3.10.2.0
1717
* [libsodium-vrf](https://github.com/IntersectMBO/libsodium)
1818
* [secp256k1](https://github.com/bitcoin-core/secp256k1)
1919
* [blst](https://github.com/supranational/blst)
@@ -42,10 +42,10 @@ dependencies.
4242
Once GHCup is installed, open a new terminal (to get an updated environment) and run:
4343

4444
```bash
45-
ghcup install ghc 8.10.7
46-
ghcup install cabal 3.10.1.0
47-
ghcup set ghc 8.10.7
48-
ghcup set cabal 3.10.1.0
45+
ghcup install ghc 9.6.7
46+
ghcup install cabal 3.10.2.0
47+
ghcup set ghc 9.6.7
48+
ghcup set cabal 3.10.2.0
4949
```
5050

5151
Check that you will use the GHCup tools (and not any other installation on the system):
@@ -236,7 +236,7 @@ Explicitly set the GHC version that we installed earlier. This avoids defaulting
236236
system version of GHC that might be different than the one you have installed.
237237

238238
```bash
239-
echo "with-compiler: ghc-8.10.7" >> cabal.project.local
239+
echo "with-compiler: ghc-9.6.7" >> cabal.project.local
240240
```
241241

242242
macOS installs OpenSSL in a different location than expected by default. If you have

doc/running.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -5,15 +5,15 @@
55
This guide assumes you have the following tools:
66

77
* [Git](https://git-scm.com/download)
8-
* [Cardano Node](https://github.com/input-output-hk/cardano-node-wiki/blob/main/docs/getting-started/install.md)
8+
* [Cardano Node](https://developers.cardano.org/docs/get-started/cardano-node/installing-cardano-node/)
99
* [Cardano DB Sync](installing.md)
1010

1111
## Download Configuration Files
1212

1313
Create a directory to store configs
1414

1515
```bash
16-
mkdir -p ~/src/cardano-environments/{mainnet,preprod,preview,sanchonet}
16+
mkdir -p ~/src/cardano-environments/{mainnet,preprod,preview}
1717
cd ~/src/cardano-environments
1818
```
1919

@@ -39,7 +39,7 @@ cardano-node run \
3939
--config ~/src/cardano-environments/config.json
4040
--topology ~/src/cardano-environments/topology.json \
4141
--database-path ~/src/cardano-environments/mainnet/db \
42-
--socket-path node.socket \
42+
--socket-path ~/src/cardano-environments/mainnet/node.socket \
4343
--host-addr 0.0.0.0
4444
```
4545

doc/schema-management.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ where the `1` denotes "stage 1" of the SQL migration, the `0000` is the migratio
3232
last number is the date. Listing the directory containing the schema and sorting the list will
3333
order them in the correct order for applying to the database.
3434

35-
Since the introduction of `use_address_table` [config](https://github.com/IntersectMBO/cardano-db-sync/blob/master/doc/configuration.md#tx-out). The file `migration-4-001-*` when indexing will not be ran when the this configuration is active.
35+
Since the introduction of `use_address_table` [config](https://github.com/IntersectMBO/cardano-db-sync/blob/master/doc/configuration.md#address-table), the `migration-4-001-*` file will not be executed during indexing when this configuration is active.
3636

3737
There is also a flag you can use in cardano-db-tool `--use-tx-out-address` which handles the alternate variation of the schema, one might be using.
3838

doc/smash.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ The first generation of SMASH server has been deployed by Input Output Global (I
1414

1515
Exchanges, for example, can use the same functionality to keep track of stake pool metadata. SMASH will allow an exchange to fetch stake pool metadata and verify its content against the on-chain registered hash. The exchange can then check existing metadata for correctness (size limits, content), create new stake pools manually, and reserve their ticker names. In case there is a stake pool with a duplicated ticker name, counterfeit or offensive content, it will be possible to delist this pool.
1616

17-
## SMASH Characteristics**
17+
## SMASH Characteristics
1818

1919
There are two main parts of SMASH:
2020

@@ -70,7 +70,7 @@ SMASH records and serves the following subset of information:
7070

7171
More information about the pool metadata (the `PoolMetaData` record) can be found [here](https://github.com/IntersectMBO/cardano-ledger/blob/4458fdba7e2211f63e7f28ecd3f9b55b02eee071/shelley/chain-and-ledger/executable-spec/src/Shelley/Spec/Ledger/TxData.hs#L62)
7272

73-
Stake pool metadata information can be also found in [The mainnet metadata Design Specification for Delegation and Incentives in Cardano](https://hydra.iohk.io/build/790053/download/1/delegation_design_spec.pdf) section 4.2 Stake Pool Metadata, p.30.
73+
Stake pool metadata information can be also found in [The mainnet metadata Design Specification for Delegation and Incentives in Cardano](https://github.com/intersectmbo/cardano-ledger/releases/latest/download/shelley-delegation.pdf) section 4.2 Stake Pool Metadata, p.30.
7474

7575

7676
## Installation

doc/syncing-and-rollbacks.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ argument to `db-sync`. This ledger state directory must persist across machine r
2626
Each ledger state is valid only for a specific block. It is not valid for any block before
2727
or any block after the block it is valid for.
2828

29-
The option `--state-dir` can be ommited when one doesn't want to use local ledger, for the omittion to work a `--disable-ledger` flag should be used, more information on what this flag does can be found [here](./configuration.md#--disable-ledger).
29+
The option `--state-dir` can be ommited when one doesn't want to use local ledger, for the omittion to work a `--disable-ledger` flag should be used, more information on what this flag does can be found [here](./configuration.md#ledger).
3030

3131

3232
## Concurrency

0 commit comments

Comments
 (0)