All apps -- all the time -- tons of improvements to make writing apps easier

.github/copilot-instructions.md

@@ -1,5 +1,87 @@
 # TrueBlocks Core Development Instructions
 
+## Operational Modes
+
+### Step-by-Step Mode (Careful Implementation)
+When I say "We want to go into step-by-step mode" or similar, switch to these rules:
+
+🚫 **Never Run Commands Without Permission:**
+- `make clean && make all`
+- `make examples`
+- `make generate`
+- `go build` or `go test`
+- Any script execution
+
+🛑 **Stop Between Steps:**
+- Never run multiple operations consecutively
+- Stop after each step for review and approval
+- Wait for explicit "go ahead" before proceeding
+
+📋 **Planning Process:**
+- Show what I want to do WITHOUT making changes first
+- Explain WHY each change is needed
+- Wait for approval before making any code or file changes
+- One step at a time with review
+
+🔒 **PERSISTENCE RULE (CRITICAL):**
+- **ONCE IN STEP-BY-STEP MODE, STAY THERE INDEFINITELY**
+- Do NOT fall back to normal mode unless explicitly told "exit step-by-step mode"
+- Step-by-step mode persists across multiple requests and conversations
+- Every action must be approved individually, no exceptions
+
+### Design Mode (Discussion + Analysis)
+When I say "Let's go into design mode" or similar, switch to these rules:
+
+📋 **Lightweight Discussion:**
+- NO full codebase scans or comprehensive exploration upfront
+- NO telling user about current code state unless specifically asked
+- Discussion-focused mode for architectural analysis and planning
+
+🔍 **Just-in-Time File Reading:**
+- Before discussing ANY specific file, component, or implementation detail, ALWAYS read that file first
+- Check file contents immediately before referencing to ensure accuracy
+- Never assume file contents based on previous knowledge - files change between requests
+- Only read files when discussion requires specific implementation details
+
+💭 **Discussion + Analysis:**
+- Architectural analysis and conceptual discussion
+- NO code modifications, builds, tests, or implementations
+- Focus on design decisions, trade-offs, and approaches
+- Reference actual code patterns only when files have been read
+
+🎯 **Focus Areas:**
+- Go architecture decisions and package design
+- Build system and CMake considerations
+- Module versioning and dependency management
+- Testing strategies and integration approaches
+- SDK generation and multi-language binding patterns
+
+📋 **Output Format:**
+- Bullet points and structured analysis
+- Pros/cons of different approaches
+- Clear recommendations with reasoning
+- Questions to clarify requirements
+
+🔒 **NO MODIFICATION RULE:**
+- **ONCE IN DESIGN MODE, STAY THERE INDEFINITELY**
+- Must explicitly exit design mode before making any code changes
+- Do NOT fall back to normal mode unless explicitly told "exit design mode"
+- Design mode persists across multiple requests and conversations
+- If asked to implement something in design mode, respond: "Still in design mode - should I exit design mode and implement this?"
+
+### Mode Switching Rules (CRITICAL)
+- **MUTUALLY EXCLUSIVE**: You can NEVER be in both design mode and step-by-step mode simultaneously
+- **Only two ways to exit each mode:**
+  1. Explicit command: "exit [mode-name] mode"
+  2. Command to enter the other mode: "go into [other-mode] mode"
+- **Mode persistence**: Once in a mode, stay there across all requests and conversations until explicitly changed
+
+### Normal Mode (Default)
+- Full autonomy to make changes, run builds, execute tests
+- Use judgment to determine appropriate actions
+- Can run multiple commands and make multiple file changes
+- Default mode when no other mode is active
+
 ## Project Overview
 
 TrueBlocks is a Go-based blockchain data indexing system that provides fast, local access to Ethereum transaction data through the "Unchained Index". The project consists of:
@@ -34,8 +116,10 @@ TrueBlocks is a Go-based blockchain data indexing system that provides fast, loc
 ```bash
 # Full build with CMake
 cd build && make
-# Go build only
-cd src/apps/chifra && go build
+# Go build only (always use -o /tmp to avoid workspace clutter)
+cd src/apps/chifra && go build -o /tmp/chifra
+# For other modules
+go build -o /tmp/[binary-name] .
 ```
 
 **Testing**: Multi-layer approach:

.gitmodules

@@ -7,3 +7,6 @@
 [submodule "sdk"]
 	path = sdk
 	url = https://github.com/TrueBlocks/trueblocks-sdk.git
+[submodule "src/dev_tools/goMaker"]
+	path = src/dev_tools/goMaker
+	url = https://github.com/TrueBlocks/goMaker.git

VERSION

@@ -1 +1 @@
-5.9.1
+5.9.3

docs/content/api/openapi.yaml

@@ -7,7 +7,7 @@ info:
   license:
     name: GPL 3.0
     url: http://www.gnu.org/licenses/
-  version: 5.9.1
+  version: 5.9.3
   description: >
     A REST layer over the TrueBlocks chifra command line. With `chifra daemon`, you can
     run this on your own machine, and make calls to `localhost`.
@@ -3586,46 +3586,50 @@ components:
       description: "an ERC-20 token approval granting spending permission from owner to spender"
       type: object
       properties:
+        allowance:
+          type: string
+          format: wei
+          description: "the amount of tokens approved for spending"
         blockNumber:
           type: number
           format: blknum
-          description: "the block number at which this call was made"
+          description: "the current block number when the report was generated"
         timestamp:
           type: number
           format: timestamp
-          description: "the timestamp of the block for this call"
+          description: "the current timestamp when the report was generated"
         date:
           type: string
           format: datetime
           description: "the timestamp as a date (calculated)"
-        address:
+        owner:
           type: string
           format: address
           description: "the address of the owner of the token (the approver)"
-        addressName:
-          type: string
-          format: string
-          description: "the name of the holder, if available"
         spender:
           type: string
           format: address
           description: "the address being granted approval to spend tokens"
-        spenderName:
-          type: string
-          format: string
-          description: "the name of the spender, if available"
-        amount:
-          type: string
-          format: wei
-          description: "the amount of tokens approved for spending"
         token:
           type: string
           format: address
           description: "the address of the ERC-20 token being approved"
-        tokenName:
-          type: string
-          format: string
-          description: "the name of the token, if available"
+        lastAppBlock:
+          type: number
+          format: blknum
+          description: "the block number of the last approval event"
+        lastAppTs:
+          type: number
+          format: timestamp
+          description: "the timestamp of the last approval event"
+        lastAppTxID:
+          type: number
+          format: txnum
+          description: "the transaction index of the last approval event"
+        lastAppLogID:
+          type: number
+          format: lognum
+          description: "the log index of the last approval event"
     appearanceTable:
       description: "an appearance table for an address"
       type: object
@@ -3884,7 +3888,7 @@ components:
           type: array
           items:
             $ref: "#/components/schemas/topic"
-          description: "the first topic hashes event signature of the log, up to 3 additional index parameters may appear"
+          description: "first topic event signature up to 3 additional index parameters may appear"
         data:
           type: string
           format: bytes
@@ -4415,7 +4419,7 @@ components:
         date:
           type: string
           format: datetime
-          description: "date when this contract state was last updated"
+          description: "date when this contract state was last updated (calculated)"
         errorCount:
           type: number
           format: int64

docs/content/data-model/accounts.md

@@ -266,18 +266,19 @@ The following commands produce and manage Approvals:
 
 Approvals consist of the following fields:
 
-| Field       | Description                                          | Type      |
-| ----------- | ---------------------------------------------------- | --------- |
-| blockNumber | the block number at which this call was made         | blknum    |
-| timestamp   | the timestamp of the block for this call             | timestamp |
-| date        | the timestamp as a date (calculated)                 | datetime  |
-| address     | the address of the owner of the token (the approver) | address   |
-| addressName | the name of the holder, if available                 | string    |
-| spender     | the address being granted approval to spend tokens   | address   |
-| spenderName | the name of the spender, if available                | string    |
-| amount      | the amount of tokens approved for spending           | wei       |
-| token       | the address of the ERC-20 token being approved       | address   |
-| tokenName   | the name of the token, if available                  | string    |
+| Field        | Description                                            | Type      |
+| ------------ | ------------------------------------------------------ | --------- |
+| allowance    | the amount of tokens approved for spending             | wei       |
+| blockNumber  | the current block number when the report was generated | blknum    |
+| timestamp    | the current timestamp when the report was generated    | timestamp |
+| date         | the timestamp as a date (calculated)                   | datetime  |
+| owner        | the address of the owner of the token (the approver)   | address   |
+| spender      | the address being granted approval to spend tokens     | address   |
+| token        | the address of the ERC-20 token being approved         | address   |
+| lastAppBlock | the block number of the last approval event            | blknum    |
+| lastAppTs    | the timestamp of the last approval event               | timestamp |
+| lastAppTxID  | the transaction index of the last approval event       | txnum     |
+| lastAppLogID | the log index of the last approval event               | lognum    |
 
 ## AppearanceTable
 

docs/content/data-model/chaindata.md

@@ -150,21 +150,21 @@ The following commands produce and manage Logs:
 
 Logs consist of the following fields:
 
-| Field            | Description                                                                                       | Type                                    |
-| ---------------- | ------------------------------------------------------------------------------------------------- | --------------------------------------- |
-| blockNumber      | the number of the block                                                                           | blknum                                  |
-| transactionIndex | the zero-indexed position of the transaction in the block                                         | txnum                                   |
-| logIndex         | the zero-indexed position of this log relative to the block                                       | lognum                                  |
-| timestamp        | the timestamp of the block this log appears in                                                    | timestamp                               |
-| date             | the timestamp as a date (calculated)                                                              | datetime                                |
-| address          | the smart contract that emitted this log                                                          | address                                 |
-| topics           | the first topic hashes event signature of the log, up to 3 additional index parameters may appear | topic[]                                 |
-| data             | any remaining un-indexed parameters to the event                                                  | bytes                                   |
-| transactionHash  | the hash of the transction                                                                        | hash                                    |
-| blockHash        | the hash of the block                                                                             | hash                                    |
-| articulatedLog   | a human-readable version of the topic and data fields                                             | [Function](/data-model/other/#function) |
-| compressedLog    | a truncated, more readable version of the articulation (calculated)                               | string                                  |
-| isNFT            | true if the log is an NFT transfer (calculated)                                                   | bool                                    |
+| Field            | Description                                                                | Type                                    |
+| ---------------- | -------------------------------------------------------------------------- | --------------------------------------- |
+| blockNumber      | the number of the block                                                    | blknum                                  |
+| transactionIndex | the zero-indexed position of the transaction in the block                  | txnum                                   |
+| logIndex         | the zero-indexed position of this log relative to the block                | lognum                                  |
+| timestamp        | the timestamp of the block this log appears in                             | timestamp                               |
+| date             | the timestamp as a date (calculated)                                       | datetime                                |
+| address          | the smart contract that emitted this log                                   | address                                 |
+| topics           | first topic event signature up to 3 additional index parameters may appear | topic[]                                 |
+| data             | any remaining un-indexed parameters to the event                           | bytes                                   |
+| transactionHash  | the hash of the transction                                                 | hash                                    |
+| blockHash        | the hash of the block                                                      | hash                                    |
+| articulatedLog   | a human-readable version of the topic and data fields                      | [Function](/data-model/other/#function) |
+| compressedLog    | a truncated, more readable version of the articulation (calculated)        | string                                  |
+| isNFT            | true if the log is an NFT transfer (calculated)                            | bool                                    |
 
 ## Trace
 

docs/content/data-model/chainstate.md

@@ -109,15 +109,15 @@ The following commands produce and manage Contracts:
 
 Contracts consist of the following fields:
 
-| Field       | Description                                              | Type                          |
-| ----------- | -------------------------------------------------------- | ----------------------------- |
-| address     | the address of this smart contract                       | address                       |
-| name        | the name of this contract (if available)                 | string                        |
-| abi         | the ABI for this contract                                | [Abi](/data-model/other/#abi) |
-| lastUpdated | timestamp when this contract state was last updated      | timestamp                     |
-| date        | date when this contract state was last updated           | datetime                      |
-| errorCount  | number of errors encountered when calling read functions | int64                         |
-| lastError   | the most recent error message when calling functions     | string                        |
+| Field       | Description                                                 | Type                          |
+| ----------- | ----------------------------------------------------------- | ----------------------------- |
+| address     | the address of this smart contract                          | address                       |
+| name        | the name of this contract (if available)                    | string                        |
+| abi         | the ABI for this contract                                   | [Abi](/data-model/other/#abi) |
+| lastUpdated | timestamp when this contract state was last updated         | timestamp                     |
+| date        | date when this contract state was last updated (calculated) | datetime                      |
+| errorCount  | number of errors encountered when calling read functions    | int64                         |
+| lastError   | the most recent error message when calling functions        | string                        |
 
 ## Base types
 

release-name.txt

@@ -1 +1 @@
-v5.9.1 Too Much To List - Lancaster
+v5.9.3 Approvals - Lancaster

scripts/go-work-sync.sh

@@ -60,7 +60,7 @@ find . -type f -name 'go.mod' | while read -r modfile; do
     fi
 
     if [ "$isSdk" = false ] && [ "$isChifra" = false ] && [ "$isGoMaker" = false ] && [ "$isFourbyte" = false ] && [ "$isIndexMan" = false ] && [ "$isKeystore" = false ]; then
-        go get github.com/TrueBlocks/trueblocks-sdk/v5@latest
+        go get github.com/TrueBlocks/trueblocks-sdk/v6@latest
     fi
 
     if [ "$isChifra" = false ]; then

src/CMakeLists.txt

@@ -104,7 +104,7 @@ endif()
 
 # ----------------------------------------------------------------------------
 add_custom_target(generate
-    COMMAND ${BIN_DIR}/goMaker
+    COMMAND goMaker
     WORKING_DIRECTORY ${REPO_DIR})
 
 # ----------------------------------------------------------------------------
@@ -146,7 +146,7 @@ add_subdirectory(other/install)
 add_go_installable_program(chifra
     ${CMAKE_SOURCE_DIR}/apps/chifra ${BIN_DIR})
 add_go_installable_program(goMaker
-    ${CMAKE_SOURCE_DIR}/dev_tools/goMaker ${BIN_DIR})
+    ${CMAKE_SOURCE_DIR}/dev_tools/goMaker /usr/local/bin)
 add_go_installable_program(indexManager
     ${CMAKE_SOURCE_DIR}/dev_tools/indexManager ${BIN_DIR})
 

src/apps/chifra/cmd/abis.go

@@ -12,11 +12,11 @@ package cmd
 import (
 	"os"
 
-	abisPkg "github.com/TrueBlocks/trueblocks-core/src/apps/chifra/internal/abis"
-	"github.com/TrueBlocks/trueblocks-core/src/apps/chifra/internal/globals"
-	"github.com/TrueBlocks/trueblocks-core/src/apps/chifra/pkg/caps"
-	"github.com/TrueBlocks/trueblocks-core/src/apps/chifra/pkg/file"
-	outputHelpers "github.com/TrueBlocks/trueblocks-core/src/apps/chifra/pkg/output/helpers"
+	abisPkg "github.com/TrueBlocks/trueblocks-core/src/apps/chifra/v6/internal/abis"
+	"github.com/TrueBlocks/trueblocks-core/src/apps/chifra/v6/internal/globals"
+	"github.com/TrueBlocks/trueblocks-core/src/apps/chifra/v6/pkg/caps"
+	"github.com/TrueBlocks/trueblocks-core/src/apps/chifra/v6/pkg/file"
+	outputHelpers "github.com/TrueBlocks/trueblocks-core/src/apps/chifra/v6/pkg/output/helpers"
 	"github.com/spf13/cobra"
 )