Haruno Knowledge base

Stellar wallets

Follow a company's Stellar wallets, see balances and activity valued in dollars and yen, and hand each month to the books so the close can check the wallets against the ledger. Haruno only reads and never holds a key.

  • Mac appNot available
  • Windows appAvailableSign-off anchoring works on the Stellar test network only.

Some companies hold money on the Stellar network, for example payments received in a dollar stablecoin. The connector named Stellar wallets follows those wallets for a company and passes each month to its books. The Portfolio can then check the wallets against the ledger in the monthly close.

It is available in the Windows app only.

It only reads. Haruno uses a wallet's public address. It never holds a secret key and never signs or sends anything on the network. If you paste a secret key anywhere, Haruno refuses it, does not save it and does not repeat it.

The pages

Four pages join the left menu, in the normal and the advanced view. Each starts with a company picker. The companies come from the Portfolio, so add the company there first. Wallets are kept per company.

Wallets

Here you register a company's wallets and sync them.

The Wallets page.
The Wallets page. A company and month are chosen, and a table lists three wallets with their purpose, network, shortened address, ledger account and last sync.The Wallets page. A company and month are chosen, and a table lists three wallets with their purpose, network, shortened address, ledger account and last sync.
  • Add wallet takes a name, what the wallet is for (receivables, treasury, payroll, expenses, team member or other), who it belongs to, whether it is on the test network or the real one, its public address, and the ledger account in the books it belongs to. A public address starts with G, or with C for a contract.
  • Month to sync and Sync now read one company's wallets for that month. Scan portfolio does it for every company that has wallets.
  • A time zone decides where a month starts and ends. Use the zone the company's books close in, UTC, Tokyo, or another offset. A month synced in another zone is synced again.
  • A sync reads the payments and balances from public Stellar services and values each movement in US dollars and Japanese yen. Then it files that month into the books for the company. The page says what was filed, and says so if wallets were left out.

Activity

One company's month: the balances of each wallet, opening and closing, with their value in dollars and yen, and then every movement.

The Activity page, for one month.
The Activity page. It shows the company's total value, cards for three assets, a table of balances per wallet, and the start of a table of movements.The Activity page. It shows the company's total value, cards for three assets, a table of balances per wallet, and the start of a table of movements.

A movement shows the time, the wallet, whether it was received or sent, the other side, the amount, the value, the memo and the invoice. Haruno matches a payment to an invoice in two ways. Matched (contract) means an invoice contract confirmed it. Needs review (memo) means only the payer's memo says so, so a person should check it. A transfer between the company's own wallets is marked Internal transfer and is not income or spending. Each transaction has a link to the public explorer.

Classification

The same holdings, shown as they would be classified under Japanese standards (ASBJ), US standards (FASB), or side by side. For each asset it shows the balance sheet line, the cash flow class and how it is valued, with the source of the rule.

The Classification page.
The Classification page. A warning says the classifications are pending confirmation by a qualified accountant. A table lists three assets with balance sheet line, cash-flow class and valuation.The Classification page. A warning says the classifications are pending confirmation by a qualified accountant. A table lists three assets with balance sheet line, cash-flow class and valuation.
Pending an accountant's confirmation

The page says these classifications come from a table of rules that is waiting for a qualified accountant to confirm it. A rule marked Draft rests on a standard that is not final. Do not present them to a customer as settled advice.

Report sign-off

Lets a reviewer put a closed month's report on the Stellar network, so anyone can later check that a PDF is the same report.

  1. Choose the month and drop the report PDF. Haruno works out the PDF's fingerprint here. Only the fingerprint leaves the computer, never the file.
  2. Press Open sign-off page. It opens in your browser. The reviewer signs the fingerprint there with their own wallet. Haruno does not sign anything.
  3. Press Check status to see whether the month is anchored, by whom and when. Open verifier page lets anyone check a PDF against it.
Test network only

Anchoring works on the Stellar test network only for now. Wallets can be on the test network or the real one, but a sign-off is not yet a real-network record.

What the close does with it

After a sync, the month's file is in the company's books. The next close reads it like any other export. The movements become transaction lines. Each wallet's balance is checked against the ledger account it is tied to. A movement that is large and has no matching book entry or invoice raises a finding, Stellar movement to explain. You set how large under Settings on the Wallets page, as the unexplained movement threshold. Stellar's other settings are there too: the explorer for transaction links, the invoice contract, and extra stablecoins to value at par.

A company with no Stellar file shows nothing about Stellar in its books.

Ask Haruno in chat

Chat can answer three questions about the wallets: which wallets a company has, their balances for a month, and the month's activity. Chat reads what the last sync kept. Sync again for fresh figures.

Good to know

  • A past month's balances are worked back from today's balance and the movements since, because the network keeps no history of balances.
  • A price Haruno cannot find is shown as unknown, never as zero, and is left out of totals.
  • Test network money is valued at real market prices so you can try things out. The page says it is not real value.
  • The network keeps only about a week of detailed history for a contract wallet, so an older month cannot be read for one.
  • Some on-chain activity, such as trades on the network's exchange, is shown as a warning on the balance and not as a movement.
  • If Haruno is too old for the connector, the pages say to update.

Last updated · PR #2944 · View this version on GitHub

History (1 version)
  1. Internal knowledge base for staff: site, reader keys, assistant, 197 pages and the PR rule (#2944)
    PR #2944Commit a2a7836The page at this version
    What changed
    @@ -0,0 +1,79 @@
+---
+title: Stellar wallets
+summary: Follow a company's Stellar wallets, see balances and activity valued in dollars and yen, and hand each month to the books so the close can check the wallets against the ledger. Haruno only reads and never holds a key.
+feature: stellar-wallets
+covers:
+  - windows-client/docs/stellar.md
+  - Integrations/stellar/**
+  - Integrations/cfo/Source/CfoStellarFiling.cs
+---
+
+Some companies hold money on the Stellar network, for example payments received in a dollar stablecoin. The connector named <Ui>Stellar wallets</Ui> follows those wallets for a company and passes each month to its books. The Portfolio can then check the wallets against the ledger in the monthly close.
+
+It is available in the Windows app only.
+
+**It only reads.** Haruno uses a wallet's public address. It never holds a secret key and never signs or sends anything on the network. If you paste a secret key anywhere, Haruno refuses it, does not save it and does not repeat it.
+
+## The pages
+
+Four pages join the left menu, in the normal and the advanced view. Each starts with a company picker. The companies come from the Portfolio, so add the company there first. Wallets are kept per company.
+
+### Wallets
+
+Here you register a company's wallets and sync them.
+
+<Shot src="/m/cf2978c51c7d-windows-books-stellar-wallets-light.png" dark="/m/ac099c2dbf40-windows-books-stellar-wallets-dark.png" alt="The Wallets page. A company and month are chosen, and a table lists three wallets with their purpose, network, shortened address, ledger account and last sync." caption="The Wallets page." />
+
+- <Ui>Add wallet</Ui> takes a name, what the wallet is for (receivables, treasury, payroll, expenses, team member or other), who it belongs to, whether it is on the test network or the real one, its public address, and the **ledger account** in the books it belongs to. A public address starts with G, or with C for a contract.
+- <Ui>Month to sync</Ui> and <Ui>Sync now</Ui> read one company's wallets for that month. <Ui>Scan portfolio</Ui> does it for every company that has wallets.
+- A **time zone** decides where a month starts and ends. Use the zone the company's books close in, UTC, Tokyo, or another offset. A month synced in another zone is synced again.
+- A sync reads the payments and balances from public Stellar services and values each movement in US dollars and Japanese yen. Then it files that month into the books for the company. The page says what was filed, and says so if wallets were left out.
+
+### Activity
+
+One company's month: the balances of each wallet, opening and closing, with their value in dollars and yen, and then every movement.
+
+<Shot src="/m/22fca673c00d-windows-books-stellar-activity-light.png" dark="/m/2141dbfb90e2-windows-books-stellar-activity-dark.png" alt="The Activity page. It shows the company's total value, cards for three assets, a table of balances per wallet, and the start of a table of movements." caption="The Activity page, for one month." />
+
+A movement shows the time, the wallet, whether it was received or sent, the other side, the amount, the value, the memo and the invoice. Haruno matches a payment to an invoice in two ways. <Ui>Matched (contract)</Ui> means an invoice contract confirmed it. <Ui>Needs review (memo)</Ui> means only the payer's memo says so, so a person should check it. A transfer between the company's own wallets is marked <Ui>Internal transfer</Ui> and is not income or spending. Each transaction has a link to the public explorer.
+
+### Classification
+
+The same holdings, shown as they would be classified under Japanese standards (ASBJ), US standards (FASB), or side by side. For each asset it shows the balance sheet line, the cash flow class and how it is valued, with the source of the rule.
+
+<Shot src="/m/3ad3dbcadcdf-windows-books-stellar-classification-light.png" dark="/m/9b8c5349a97a-windows-books-stellar-classification-dark.png" alt="The Classification page. A warning says the classifications are pending confirmation by a qualified accountant. A table lists three assets with balance sheet line, cash-flow class and valuation." caption="The Classification page." />
+
+<Callout variant="warning" title="Pending an accountant's confirmation">
+The page says these classifications come from a table of rules that is waiting for a qualified accountant to confirm it. A rule marked <Ui>Draft</Ui> rests on a standard that is not final. Do not present them to a customer as settled advice.
+</Callout>
+
+### Report sign-off
+
+Lets a reviewer put a closed month's report on the Stellar network, so anyone can later check that a PDF is the same report.
+
+1. Choose the month and drop the report PDF. Haruno works out the PDF's fingerprint here. Only the fingerprint leaves the computer, never the file.
+2. Press <Ui>Open sign-off page</Ui>. It opens in your browser. The reviewer signs the fingerprint there with their own wallet. Haruno does not sign anything.
+3. Press <Ui>Check status</Ui> to see whether the month is anchored, by whom and when. <Ui>Open verifier page</Ui> lets anyone check a PDF against it.
+
+<Callout variant="info" title="Test network only">
+Anchoring works on the Stellar test network only for now. Wallets can be on the test network or the real one, but a sign-off is not yet a real-network record.
+</Callout>
+
+## What the close does with it
+
+After a sync, the month's file is in the company's books. The next close reads it like any other export. The movements become transaction lines. Each wallet's balance is checked against the ledger account it is tied to. A movement that is large and has no matching book entry or invoice raises a finding, <Ui>Stellar movement to explain</Ui>. You set how large under <Ui>Settings</Ui> on the Wallets page, as the unexplained movement threshold. Stellar's other settings are there too: the explorer for transaction links, the invoice contract, and extra stablecoins to value at par.
+
+A company with no Stellar file shows nothing about Stellar in its books.
+
+## Ask Haruno in chat
+
+Chat can answer three questions about the wallets: which wallets a company has, their balances for a month, and the month's activity. Chat reads what the last sync kept. Sync again for fresh figures.
+
+## Good to know
+
+- A past month's balances are worked back from today's balance and the movements since, because the network keeps no history of balances.
+- A price Haruno cannot find is shown as **unknown**, never as zero, and is left out of totals.
+- Test network money is valued at real market prices so you can try things out. The page says it is not real value.
+- The network keeps only about a week of detailed history for a contract wallet, so an older month cannot be read for one.
+- Some on-chain activity, such as trades on the network's exchange, is shown as a warning on the balance and not as a movement.
+- If Haruno is too old for the connector, the pages say to update.