Skip to content

Conversation

@ProudOfZiggy
Copy link

@ProudOfZiggy ProudOfZiggy commented Nov 18, 2025

Closes #1304

ProudOfZiggy and others added 30 commits November 13, 2025 00:05
@github-actions
Copy link

Skipping AI review because this PR is from a fork. A maintainer can start the review by commenting /review in this PR.

@anton-trunov
Copy link
Collaborator

@ProudOfZiggy please revert the changes in unrelated pages

Copy link
Collaborator

@anton-trunov anton-trunov left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

please fix the merge conflicts and revert the unrelated changes

@anton-trunov anton-trunov marked this pull request as draft November 18, 2025 11:50
@verytactical verytactical added the 3p Reviewed by someone else (a third party). Used for filtering PRs. Don't mind this. label Nov 18, 2025
@ProudOfZiggy ProudOfZiggy marked this pull request as ready for review November 18, 2025 12:01
@anton-trunov
Copy link
Collaborator

Also, each PR should have its corresponding issue: please see our workflow and policies here: #314

@anton-trunov anton-trunov marked this pull request as draft November 18, 2025 12:29
@ProudOfZiggy ProudOfZiggy marked this pull request as ready for review November 18, 2025 12:55
@anton-trunov anton-trunov changed the title Mobile WalletKit usage documentation feat: mobile WalletKit Nov 20, 2025
@anton-trunov
Copy link
Collaborator

/review

Copy link

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the updates—nice progress. I left several suggestions across ecosystem/ton-connect/walletkit/android and ecosystem/ton-connect/walletkit/ios; please apply the inline suggestions.

Comment on lines +61 to +63
```kotlin
wallet.sendTransaction(transaction)
```

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[HIGH] Missing safety callout for sending transactions (Android)

The page sends a transaction (wallet.sendTransaction(transaction)) without a Warning/Caution callout. Funds movement requires an explicit safety notice and safer defaults (testnet first). This omission increases the risk of users sending irreversible mainnet transactions without adequate context.

Suggested change
```kotlin
wallet.sendTransaction(transaction)
```
<Aside type="danger" title="Funds at risk">
Approving or sending a transaction on mainnet transfers funds irreversibly. Use testnet during development.
</Aside>

Please leave a reaction 👍/👎 to this suggestion to improve future reviews for everyone!

Comment on lines +36 to +38
<Aside type="note">
Always store mnemonic phrases securely using platform-specific encrypted storage. Never store them in plain text.
</Aside>

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[HIGH] Missing safety callout for secrets (mnemonics/keys)

This section uses a Note while discussing mnemonics/keys; handling secrets requires a Warning/Danger callout with risk, scope, mitigation, and environment guidance. Lines 36–38 contain the existing Note and are part of the PR diff. Upgrade the callout and include the required content.

Please leave a reaction 👍/👎 to this suggestion to improve future reviews for everyone!

Comment on lines +40 to +65
let jettonAddress = "EQCxE..."
// Returns balance in nano with decimals count according to Jetton specification
let balance = try await wallet.jettonBalance(jettonAddress: jettonAddress)
```

### Get Jetton wallet address

```swift
let jettonAddress = "EQCxE..."
let walletAddress = try await wallet.jettonWalletAddress(jettonAddress: jettonAddress)
```

## NFTs

### Get all NFTs

```swift
let nfts = try await wallet.nfts(limit: TONLimitRequest(limit: 10, offset: 0))
```

### Get specific NFT

```swift
let nftAddress = "EQCA..."
let nft = wallet.nft(address: nftAddress)
```

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[HIGH] Silently truncated addresses in examples

Examples include truncated addresses like “EQCxE…” without stating truncation or using placeholders. Replace literals with placeholders and define them on first use. Occurrences in this range are part of the PR diff.

Please leave a reaction 👍/👎 to this suggestion to improve future reviews for everyone!

Comment on lines +76 to +78
```swift
try await wallet.send(transaction: transaction)
```

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[HIGH] Missing safety callout for sending transactions (iOS)

The page sends a transaction (try await wallet.send(transaction: transaction)) without a Warning/Caution callout. Because sending is irreversible on mainnet, a safety notice and testnet-first defaults are required.

Suggested change
```swift
try await wallet.send(transaction: transaction)
```
<Aside type="danger" title="Funds at risk">
Approving or sending a transaction on mainnet transfers funds irreversibly. Use testnet during development.
</Aside>

Please leave a reaction 👍/👎 to this suggestion to improve future reviews for everyone!

Comment on lines +36 to +38
<Aside type="note">
Always store mnemonic phrases securely using platform-specific encrypted storage. Never store them in plain text.
</Aside>

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[HIGH] Missing safety callout for secrets (mnemonics/keys)

This section uses a Note while handling mnemonics/keys; secrets require a Warning/Danger callout with risk, scope, mitigation, and environment guidance. Lines 36–38 contain the existing Note and are part of the PR diff. Replace with a danger callout and include required content.

Please leave a reaction 👍/👎 to this suggestion to improve future reviews for everyone!

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
@novusnota novusnota marked this pull request as draft November 21, 2025 09:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

3p Reviewed by someone else (a third party). Used for filtering PRs. Don't mind this.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Ecosystem] Add minimal mobile (iOS and Android) documentation for WalletKit SDK

5 participants