docs: Add On-chain tracking page

[germartinez]

Context

This PR:

• Adds a new page for on-chain tracking.
• Points to the on-chain tracking page from Protocol Kit and Relay Kit guides.
• Removes on-chain tracking sections in existing guides and points to the new page.

[github-actions]

Branch preview

✅ Deployed successfully in branch deployment:

https://onchain_tracking--docs.review.5afe.dev

[github-actions]

Overall readability score: 31.23 (🔴 -0.08)

File	Readability
getOnchainIdentifier.mdx	6.11 (-)
onchain-tracking.mdx	35.03 (-)
execute-transactions.mdx	40.73 (🔴 -0.23)
multichain-safe-deployment.mdx	34.71 (🟢 +0.7)
safe-deployment.mdx	25.51 (🟢 +1.5)
4337-safe-sdk.mdx	31.71 (🔴 -4.85)

View detailed metrics

🟢 - Shows an increase in readability
🔴 - Shows a decrease in readability

File	Readability	FRE	GF	ARI	CLI	DCRS
getOnchainIdentifier.mdx	6.11	0	16.84	22	19	10.25
	-	-	-	-	-	-
onchain-tracking.mdx	35.03	29.48	14.03	18.9	14.28	7.74
	-	-	-	-	-	-
execute-transactions.mdx	40.73	40.92	14.87	18.9	11.56	7.3
	🔴 -0.23	🟢 +0.1	🟢 +0.09	🔴 -0.1	🔴 -0.23	🟢 +0.02
multichain-safe-deployment.mdx	34.71	34.39	14.83	20	13.18	7.65
	🟢 +0.7	🔴 -7.14	🟢 +0.3	🟢 +0.7	🟢 +0.18	🟢 +0.03
safe-deployment.mdx	25.51	32.46	16.52	21.7	13.94	8.41
	🟢 +1.5	🟢 +2.33	🟢 +0.49	🟢 +0.3	🔴 -0.18	🟢 +0.03
4337-safe-sdk.mdx	31.71	36.76	17.32	20.6	11.44	7.87
	🔴 -4.85	🔴 -2.44	🔴 -1.11	🔴 -1.2	🔴 -0.11	🔴 -0.2

Averages:

	Readability	FRE	GF	ARI	CLI	DCRS
Average	31.23	27.18	13.72	17.46	15.74	8.98
	🔴 -0.08	🔴 -0.1	🔴 -0.01	🔴 -0.02	🔴 -0.01	🟢 +0

View metric targets

Metric	Range	Ideal score
Flesch Reading Ease	100 (very easy read) to 0 (extremely difficult read)	60
Gunning Fog	6 (very easy read) to 17 (extremely difficult read)	8 or less
Auto. Read. Index	6 (very easy read) to 14 (extremely difficult read)	8 or less
Coleman Liau Index	6 (very easy read) to 17 (extremely difficult read)	8 or less
Dale-Chall Readability	4.9 (very easy read) to 9.9 (extremely difficult read)	6.9 or less

[DaniSomoza]

The on-chain identifier will always be appended to the end of the data field of the deployment transaction, both for Safe deployments and Safe transactions. Using the paymentReceiver or saltNonce was an initial idea, but it's not part of the final implementation.

[germartinez]

Yes, I know that is how the SDK works, but here it refers about the different options that exist for people using onchain tracking without the SDK. This sections has two paragrap: the initial one that shows the different options and the second one that shows how the SDK works. I will make it more explicit that the SDK only uses data.

[DaniSomoza]

How about we add a comment like this to help developers better understand? It clarifies that the project field is mandatory and should remain consistent for each project:

project: 'YOUR_PROJECT_NAME' // Required. Always use the same value for your project, e.g., 'Cow Swap' or 'AAVE'.

[germartinez]

Sounds good. I will make a reference that this field is linked to the Project hash explained in the format section.

[DaniSomoza]

Should we include the new getOnchainIdentifier function in the protocol-kit reference?

[DaniSomoza]

I think that some external projects were interested in implementing their own solution compatible with our onchain identifier.

Should we add a simple entry in the documentation to guide them?

We could explain how to use keccak256 to generate their identifiers with the correct values. We can provide our generateOnChainIdentifier function as an example:

function generateOnChainIdentifier({
  project,
  platform = 'Web',
  tool,
  toolVersion
}: OnChainIdentifierParamsType): string {
  const identifierPrefix = '5afe'
  const identifierVersion = '00' // first version
  const projectHash = generateHash(project, 20) // Take the last 20 bytes
  const platformHash = generateHash(platform, 3) // Take the last 3 bytes
  const toolHash = generateHash(tool, 3) // Take the last 3 bytes
  const toolVersionHash = generateHash(toolVersion, 3) // Take the last 3 bytes

  return `${identifierPrefix}${identifierVersion}${projectHash}${platformHash}${toolHash}${toolVersionHash}`
}

export function generateHash(input: string, size: number): string {
  const fullHash = keccak256(toHex(input))
  return toHex(fullHash.slice(-size)).replace('0x', '') // Take the last X bytes
}