didww-v3 5.1.0 → 5.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 39b910fbb0b5dc4425cf053fd6cacef936c7c46510f8586d33784cccad18a95e
-  data.tar.gz: 1dae18d3341a93e2a2b4c74d81e224e0402a8c7020bda0053fb685be5186abb2
+  metadata.gz: df4c6143fca0f8b1f6c6d5c4e43fc89a71a4a9fcc5b63b3b63c3bb9ab03ce102
+  data.tar.gz: dd9ad527373290850d9555f1117aa097aa534497668115fdcbb9dd2f2323f783
 SHA512:
-  metadata.gz: eba0ac2332cf5f0f4c1f65155c0714d9ce35f0a96227024d2b3a21ab650c44587c789035cfb3dd995d797a08573e821eb1301e00732f91cdb3732175c163177c
-  data.tar.gz: a1ebd2311fa0b1f190d068a210ccfe583b74e3b6ec83c7ad368f2f2eb69d2bdf7d40b8ad5ddb98ab2828b2061ce20a77a67db2406b9c30e5ed4f417d20454259
+  metadata.gz: 32dc4dc452c8ef98f1855ec47aee83cd7959f9abc3c3ade68489610d71600a8bcf1e232cb4a4e3a76ffae9a5b68adb19d133b8788d6d4ba7711dff36141c96b4
+  data.tar.gz: e759ef5119ea80accac264b297e4730f9391e774adc47d7dca853b0c9d79f6c1d2af4a61562e849af04c4a4ba476213a18696a9e88c7f8ee92b811c68059a09e

data/README.md

@@ -51,17 +51,17 @@ Or install it yourself as:
 ```ruby
 require 'didww'
 
-client = DIDWW::Client.configure do |config|
+DIDWW::Client.configure do |config|
   config.api_key  = 'YOUR_API_KEY'
   config.api_mode = :sandbox
 end
 
 # Check balance
-balance = client.balance
+balance = DIDWW::Client.balance
 puts "Balance: #{balance.total_balance}"
 
 # List DID groups with stock keeping units
-did_groups = client.did_groups.all(
+did_groups = DIDWW::Client.did_groups.all(
   include: 'stock_keeping_units',
   filter: { area_name: 'Acapulco' }
 )
@@ -69,14 +69,10 @@ did_groups = client.did_groups.all(
 puts "DID groups: #{did_groups.count}"
 ```
 
-For more examples visit [examples](examples/).
-
 For details on obtaining your API key please visit https://doc.didww.com/api3/configuration.html
 
 ## Examples
 
-- Source code: [examples/](examples/)
-- How to run: [examples/README.md](examples/README.md)
 - Rails integration sample: https://github.com/didww/didww-v3-rails-sample
 
 ## Configuration
@@ -168,6 +164,7 @@ trunk = DIDWW::Client.voice_in_trunks.new(
   name: 'My SIP Trunk',
   configuration: {
     type: 'sip_configurations',
+    username: '{DID}',
     host: 'sip.example.com',
     port: 5060
   }
@@ -192,10 +189,70 @@ order = DIDWW::Client.orders.new(
 order.save
 ```
 
+## Date and Datetime Fields
+
+The SDK distinguishes between date-only and datetime fields:
+
+- **Datetime fields** — deserialized as `Time`:
+  - All `created_at` fields — present on most resources (`EncryptedFile` has no `created_at`)
+  - Expiry fields: `Did#expires_at`, `DidReservation#expire_at`, `Proof#expires_at`, `EncryptedFile#expire_at`
+- **Date-only fields** — deserialized as `Date`:
+  - `Identity#birth_date`
+- **Date-only fields kept as strings** (`CapacityPool#renew_date`) remain as `String`.
+
+```ruby
+did = DIDWW::Client.dids.find("uuid").first
+puts did.created_at   # => 2024-01-15 10:00:00 UTC  (Time)
+puts did.expires_at   # => nil or 2025-01-15 10:00:00 UTC  (Time)
+
+identity = DIDWW::Client.identities.find("uuid").first
+puts identity.birth_date  # => 1990-05-20  (Date)
+```
+
 ## Resource Relationships
 
 See [docs/resource_relationships.md](docs/resource_relationships.md) for a Mermaid ER diagram showing all `has_one`, `has_many`, and `belongs_to` relationships between resources.
 
+## Webhook Signature Validation
+
+Validate incoming webhook callbacks from DIDWW using HMAC-SHA1 signature verification.
+
+```ruby
+require 'didww/callback/request_validator'
+
+validator = DIDWW::Callback::RequestValidator.new("YOUR_API_KEY")
+
+# In your webhook handler:
+valid = validator.validate(
+  request_url,    # full original URL
+  payload_params, # Hash of payload key-value pairs
+  signature       # value of X-DIDWW-Signature header
+)
+```
+
+The signature header name is available as the constant `DIDWW::Callback::RequestValidator::HEADER`.
+
+### Rails Example
+
+```ruby
+class WebhooksController < ApplicationController
+  skip_before_action :verify_authenticity_token
+
+  def create
+    validator = DIDWW::Callback::RequestValidator.new("YOUR_API_KEY")
+    signature = request.headers[DIDWW::Callback::RequestValidator::HEADER]
+    params_hash = request.POST
+
+    if validator.validate(request.original_url, params_hash, signature)
+      # Process the webhook
+      head :ok
+    else
+      head :forbidden
+    end
+  end
+end
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/examples/README.md

@@ -0,0 +1,86 @@
+# Examples
+
+All examples read the API key from the `DIDWW_API_KEY` environment variable.
+
+## Prerequisites
+
+- Ruby 3.3+
+- Bundler
+- DIDWW API key for sandbox account
+
+## Environment variables
+
+- `DIDWW_API_KEY` (required): your DIDWW API key
+
+## Install
+
+```bash
+cd examples && bundle install
+```
+
+## Run an example
+
+```bash
+DIDWW_API_KEY=your_api_key ruby examples/orders_nanpa.rb
+```
+
+## Available examples
+
+### Core Resources
+| Script | Description |
+|---|---|
+| [`balance.rb`](balance.rb) | Fetches and prints current account balance and credit. |
+| [`countries.rb`](countries.rb) | Lists countries, demonstrates filtering, and fetches one country by ID. |
+| [`regions.rb`](regions.rb) | Lists regions with filters/includes and fetches a specific region. |
+| [`did_groups.rb`](did_groups.rb) | Fetches DID groups with included SKUs and shows group details. |
+| [`dids.rb`](dids.rb) | Updates DID routing/capacity by assigning trunk and capacity pool. |
+| [`exports.rb`](exports.rb) | Lists CDR exports and their details. |
+
+### Voice In (Inbound)
+| Script | Description |
+|---|---|
+| [`voice_in_trunks.rb`](voice_in_trunks.rb) | Lists voice in trunks and their configurations. |
+| [`voice_in_trunk_groups.rb`](voice_in_trunk_groups.rb) | CRUD for trunk groups with trunk relationships. |
+
+### Voice Out (Outbound)
+| Script | Description |
+|---|---|
+| [`voice_out_trunks.rb`](voice_out_trunks.rb) | CRUD for voice out trunks (requires account config). |
+
+### Capacity Management
+| Script | Description |
+|---|---|
+| [`capacity_pools.rb`](capacity_pools.rb) | Lists capacity pools with included shared capacity groups. |
+| [`shared_capacity_groups.rb`](shared_capacity_groups.rb) | Creates a shared capacity group in a capacity pool. |
+
+### Orders - Basic
+| Script | Description |
+|---|---|
+| [`orders.rb`](orders.rb) | Lists orders and creates/cancels a DID order using live SKU lookup. |
+| [`orders_nanpa.rb`](orders_nanpa.rb) | Orders a DID number by NPA/NXX prefix. |
+| [`orders_by_sku.rb`](orders_by_sku.rb) | Creates a DID order by SKU resolved from DID groups. |
+| [`orders_capacity.rb`](orders_capacity.rb) | Purchases capacity by creating a capacity order item. |
+
+### Orders - Advanced
+| Script | Description |
+|---|---|
+| [`orders_available_dids.rb`](orders_available_dids.rb) | Orders an available DID using included DID group SKU. |
+| [`orders_reservation_dids.rb`](orders_reservation_dids.rb) | Reserves a DID and then places an order from that reservation. |
+| [`orders_all_item_types.rb`](orders_all_item_types.rb) | Creates a DID order with all item types: by SKU, available DID, and reservation. |
+
+### DID Management
+| Script | Description |
+|---|---|
+| [`did_reservations.rb`](did_reservations.rb) | Lists DID reservations and available DIDs. |
+| [`did_trunk_assignment.rb`](did_trunk_assignment.rb) | Demonstrates exclusive trunk/trunk group assignment on DIDs. |
+
+### Compliance & Verification
+| Script | Description |
+|---|---|
+| [`identities_and_proofs.rb`](identities_and_proofs.rb) | Creates identities, addresses, and demonstrates proof workflow. |
+
+## Troubleshooting
+
+If `DIDWW_API_KEY` is missing, examples fail fast with:
+
+`Please set DIDWW_API_KEY`

data/examples/balance.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+# Fetches and prints current account balance and credit.
+#
+# Usage: DIDWW_API_KEY=your_api_key ruby examples/balance.rb
+
+require 'bundler/setup'
+require 'didww'
+
+DIDWW::Client.configure do |client|
+  client.api_key  = ENV.fetch('DIDWW_API_KEY') { abort 'Please set DIDWW_API_KEY' }
+  client.api_mode = :sandbox
+end
+
+balance = DIDWW::Client.balance
+puts "Total Balance: #{balance.total_balance}"
+puts "Balance: #{balance.balance}"
+puts "Credit: #{balance.credit}"

data/examples/capacity_pools.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+# Lists capacity pools with included shared capacity groups.
+#
+# Usage: DIDWW_API_KEY=your_api_key ruby examples/capacity_pools.rb
+
+require 'bundler/setup'
+require 'didww'
+
+DIDWW::Client.configure do |client|
+  client.api_key  = ENV.fetch('DIDWW_API_KEY') { abort 'Please set DIDWW_API_KEY' }
+  client.api_mode = :sandbox
+end
+
+# List capacity pools with included shared capacity groups
+puts '=== Capacity Pools ==='
+capacity_pools = DIDWW::Client.capacity_pools
+                  .includes(:shared_capacity_groups)
+                  .all
+
+puts "Found #{capacity_pools.size} capacity pools"
+
+capacity_pools.each do |pool|
+  puts "\nCapacity Pool: #{pool.name}"
+  puts "  Total channels: #{pool.total_channels_count}"
+  puts "  Assigned channels: #{pool.assigned_channels_count}"
+  puts "  Monthly price: #{pool.monthly_price}"
+  puts "  Metered rate: #{pool.metered_rate}"
+
+  if pool.shared_capacity_groups && !pool.shared_capacity_groups.empty?
+    puts '  Shared Capacity Groups:'
+    pool.shared_capacity_groups.each do |group|
+      puts "    - #{group.name} (#{group.shared_channels_count} channels)"
+    end
+  end
+end

data/examples/countries.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+# Lists countries, demonstrates filtering, and fetches one country by ID.
+#
+# Usage: DIDWW_API_KEY=your_api_key ruby examples/countries.rb
+
+require 'bundler/setup'
+require 'didww'
+
+DIDWW::Client.configure do |client|
+  client.api_key  = ENV.fetch('DIDWW_API_KEY') { abort 'Please set DIDWW_API_KEY' }
+  client.api_mode = :sandbox
+end
+
+# List all countries
+puts '=== All Countries ==='
+countries = DIDWW::Client.countries.all
+countries.first(5).each do |country|
+  puts "#{country.name} (+#{country.prefix}) [#{country.iso}]"
+end
+
+# Filter countries by name
+puts "\n=== Filtered Countries (United States) ==="
+filtered = DIDWW::Client.countries.where(name: 'United States').all
+puts "Found: #{filtered.size} countries"
+filtered.each do |country|
+  puts "#{country.name} (+#{country.prefix})"
+end
+
+# Find a specific country
+if !filtered.empty?
+  puts "\n=== Specific Country ==="
+  country = DIDWW::Client.countries.find(filtered.first.id).first
+  puts "Found: #{country.name}"
+end

data/examples/did_groups.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+# Fetches DID groups with included SKUs and shows group details.
+#
+# Usage: DIDWW_API_KEY=your_api_key ruby examples/did_groups.rb
+
+require 'bundler/setup'
+require 'didww'
+
+DIDWW::Client.configure do |client|
+  client.api_key  = ENV.fetch('DIDWW_API_KEY') { abort 'Please set DIDWW_API_KEY' }
+  client.api_mode = :sandbox
+end
+
+# Fetch DID groups with included stock_keeping_units
+puts '=== DID Groups with SKUs ==='
+did_groups = DIDWW::Client.did_groups
+              .includes(:stock_keeping_units)
+              .all
+
+puts "Found #{did_groups.size} DID groups"
+
+did_groups.first(3).each do |did_group|
+  puts "\nDID Group: #{did_group.id}"
+  puts "  Area: #{did_group.area_name}"
+  puts "  Prefix: #{did_group.prefix}"
+  puts "  Metered: #{did_group.is_metered}"
+  puts "  Features: #{did_group.features_human}"
+
+  if did_group.stock_keeping_units && !did_group.stock_keeping_units.empty?
+    puts '  SKUs:'
+    did_group.stock_keeping_units.each do |sku|
+      puts "    - #{sku.id} (monthly: #{sku.monthly_price})"
+    end
+  end
+end
+
+# Find a specific DID group
+if !did_groups.empty?
+  puts "\n=== Specific DID Group ==="
+  did_group = DIDWW::Client.did_groups
+               .includes(:stock_keeping_units)
+               .find(did_groups.first.id)
+               .first
+  puts "Found: #{did_group.area_name} (prefix: #{did_group.prefix})"
+end

data/examples/did_reservations.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+# Lists DID reservations and available DIDs.
+#
+# Usage: DIDWW_API_KEY=your_api_key ruby examples/did_reservations.rb
+
+require 'bundler/setup'
+require 'didww'
+
+DIDWW::Client.configure do |client|
+  client.api_key  = ENV.fetch('DIDWW_API_KEY') { abort 'Please set DIDWW_API_KEY' }
+  client.api_mode = :sandbox
+end
+
+# List DID reservations
+puts '=== Existing DID Reservations ==='
+reservations = DIDWW::Client.did_reservations
+                .includes(:available_did)
+                .all
+
+puts "Found #{reservations.size} DID reservations"
+reservations.first(10).each do |reservation|
+  did_number = reservation.available_did ? reservation.available_did.number : 'unknown'
+  puts "#{reservation.id}"
+  puts "  DID: #{did_number}"
+  puts "  Expires: #{reservation.expire_at}"
+  puts "  Created: #{reservation.created_at}"
+  puts ''
+end
+
+# List available DIDs
+puts "\n=== Available DIDs ==="
+available_dids = DIDWW::Client.available_dids
+                  .includes(:did_group)
+                  .all
+
+puts "Found #{available_dids.size} available DIDs"
+available_dids.first(10).each do |available_did|
+  puts "#{available_did.number}"
+  if available_did.did_group
+    puts "  Group: #{available_did.did_group.area_name}"
+    puts "  Prefix: #{available_did.did_group.prefix}"
+  end
+  puts ''
+end
+
+# Find a specific reservation if available
+if !reservations.empty?
+  puts "\n=== Specific Reservation Details ==="
+  specific_reservation = DIDWW::Client.did_reservations
+                         .find(reservations.first.id)
+                         .first
+  puts "Reservation: #{specific_reservation.id}"
+  puts "  Expires at: #{specific_reservation.expire_at}"
+  puts "  Created at: #{specific_reservation.created_at}"
+end

data/examples/did_trunk_assignment.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+# Demonstrates exclusive trunk/trunk group assignment on DIDs.
+# Assigning a trunk auto-nullifies the trunk group and vice versa.
+#
+# Usage: DIDWW_API_KEY=your_api_key ruby examples/did_trunk_assignment.rb
+
+require 'bundler/setup'
+require 'didww'
+
+DIDWW::Client.configure do |client|
+  client.api_key  = ENV.fetch('DIDWW_API_KEY') { abort 'Please set DIDWW_API_KEY' }
+  client.api_mode = :sandbox
+end
+
+# Get a DID to work with
+puts '=== Finding DID ==='
+dids = DIDWW::Client.dids
+       .includes(:voice_in_trunk, :voice_in_trunk_group)
+       .all
+
+if dids.empty?
+  puts 'No DIDs found. Please order a DID first.'
+  exit 1
+end
+
+did = dids.first
+puts "Using DID: #{did.number} (#{did.id})"
+
+# Get a trunk
+puts "\n=== Finding Trunk ==="
+trunks = DIDWW::Client.voice_in_trunks.all
+
+if trunks.empty?
+  puts 'No trunks found. Please create a trunk first.'
+  exit 1
+end
+
+trunk = trunks.first
+puts "Selected trunk: #{trunk.name} (#{trunk.id})"
+
+# Get a trunk group
+puts "\n=== Finding Trunk Group ==="
+trunk_groups = DIDWW::Client.voice_in_trunk_groups.all
+
+if trunk_groups.empty?
+  puts 'No trunk groups found. Please create a trunk group first.'
+  exit 1
+end
+
+trunk_group = trunk_groups.first
+puts "Selected trunk group: #{trunk_group.name} (#{trunk_group.id})"
+
+def print_did_assignment(client, did_id)
+  result = client.dids
+           .includes(:voice_in_trunk, :voice_in_trunk_group)
+           .find(did_id)
+           .first
+  trunk = result.voice_in_trunk ? result.voice_in_trunk.id : 'null'
+  group = result.voice_in_trunk_group ? result.voice_in_trunk_group.id : 'null'
+  puts "   trunk = #{trunk}"
+  puts "   group = #{group}"
+end
+
+begin
+  # 1. Assign trunk to DID (auto-nullifies trunk group)
+  puts "\n=== 1. Assigning trunk to DID ==="
+  did.voice_in_trunk = trunk
+  if did.save
+    print_did_assignment(DIDWW::Client, did.id)
+  else
+    puts "Error assigning trunk: #{did.errors.full_messages}"
+  end
+
+  # 2. Assign trunk group to DID (auto-nullifies trunk)
+  puts "\n=== 2. Assigning trunk group to DID ==="
+  did_fresh = DIDWW::Client.dids.find(did.id).first
+  did_fresh.voice_in_trunk_group = trunk_group
+  if did_fresh.save
+    print_did_assignment(DIDWW::Client, did.id)
+  else
+    puts "Error assigning trunk group: #{did_fresh.errors.full_messages}"
+  end
+
+  # 3. Re-assign trunk (auto-nullifies trunk group again)
+  puts "\n=== 3. Re-assigning trunk ==="
+  did_fresh = DIDWW::Client.dids.find(did.id).first
+  did_fresh.voice_in_trunk = trunk
+  if did_fresh.save
+    print_did_assignment(DIDWW::Client, did.id)
+  else
+    puts "Error re-assigning trunk: #{did_fresh.errors.full_messages}"
+  end
+
+  # 4. Update description only (trunk stays assigned)
+  puts "\n=== 4. Updating description only (trunk stays) ==="
+  did_fresh = DIDWW::Client.dids.find(did.id).first
+  did_fresh.description = 'DID with trunk assigned'
+  if did_fresh.save
+    print_did_assignment(DIDWW::Client, did.id)
+  else
+    puts "Error updating description: #{did_fresh.errors.full_messages}"
+  end
+
+  puts "\nDemonstration complete!"
+rescue StandardError => e
+  puts "Error: #{e.message}"
+end

data/examples/dids.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+# Updates DID routing/capacity by assigning trunk and capacity pool.
+#
+# Usage: DIDWW_API_KEY=your_api_key ruby examples/dids.rb
+
+require 'bundler/setup'
+require 'didww'
+
+DIDWW::Client.configure do |client|
+  client.api_key  = ENV.fetch('DIDWW_API_KEY') { abort 'Please set DIDWW_API_KEY' }
+  client.api_mode = :sandbox
+end
+
+# Get the last ordered DID
+puts '=== Finding last ordered DID ==='
+dids = DIDWW::Client.dids
+        .all
+
+if dids.empty?
+  puts 'No DIDs found. Please order a DID first.'
+  exit 1
+end
+
+did = dids.first
+puts "Selected DID: #{did.id}"
+
+# Get last SIP trunk
+puts "\n=== Finding SIP trunk ==="
+trunks = DIDWW::Client.voice_in_trunks
+          .where('configuration.type': 'sip_configurations')
+          .all
+
+if trunks.empty?
+  puts 'No SIP trunks found. Please create a SIP trunk first.'
+  exit 1
+end
+
+trunk = trunks.first
+puts "Selected trunk: #{trunk.name}"
+
+# Assign trunk to DID
+puts "\n=== Assigning trunk to DID ==="
+did.voice_in_trunk = trunk
+updated_did = did.save
+puts "Assigned trunk: #{did.voice_in_trunk.name if did.voice_in_trunk}"
+
+# Assign capacity pool
+puts "\n=== Assigning capacity pool ==="
+capacity_pools = DIDWW::Client.capacity_pools.all
+
+if !capacity_pools.empty?
+  pool = capacity_pools.first
+  did.capacity_pool = pool
+  did.capacity_limit = 5
+  did.description = 'Updated by Ruby example'
+  did.save
+  puts "DID #{did.id}"
+  puts "  description: #{did.description}"
+  puts "  capacity_limit: #{did.capacity_limit}"
+else
+  puts 'No capacity pools found'
+end

data/examples/exports.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+# Lists CDR exports and their details.
+#
+# Usage: DIDWW_API_KEY=your_api_key ruby examples/exports.rb
+
+require 'bundler/setup'
+require 'didww'
+
+DIDWW::Client.configure do |client|
+  client.api_key  = ENV.fetch('DIDWW_API_KEY') { abort 'Please set DIDWW_API_KEY' }
+  client.api_mode = :sandbox
+end
+
+# List exports
+puts '=== Existing Exports ==='
+exports = DIDWW::Client.exports.all
+puts "Found #{exports.size} exports"
+
+exports.first(10).each do |export|
+  puts "Export: #{export.id}"
+  puts "  Type: #{export.export_type}"
+  puts "  Status: #{export.status}"
+  puts "  Created: #{export.created_at}"
+  puts "  URL: #{export.url}" if export.url
+  puts "  Callback URL: #{export.callback_url}" if export.callback_url
+  puts ''
+end
+
+# Find a specific export if available
+if !exports.empty?
+  puts "\n=== Specific Export Details ==="
+  specific_export = DIDWW::Client.exports
+                    .find(exports.first.id)
+                    .first
+  puts "Export: #{specific_export.id}"
+  puts "  Type: #{specific_export.export_type}"
+  puts "  Status: #{specific_export.status}"
+  puts "  Created: #{specific_export.created_at}"
+  if specific_export.filters
+    puts '  Filters:'
+    puts "    Year: #{specific_export.filters.year}"
+    puts "    Month: #{specific_export.filters.month}"
+  end
+end

data/examples/identities_and_proofs.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+# Lists identities, addresses, and proofs. Demonstrates compliance workflow.
+#
+# Usage: DIDWW_API_KEY=your_api_key ruby examples/identities_and_proofs.rb
+
+require 'bundler/setup'
+require 'didww'
+
+DIDWW::Client.configure do |client|
+  client.api_key  = ENV.fetch('DIDWW_API_KEY') { abort 'Please set DIDWW_API_KEY' }
+  client.api_mode = :sandbox
+end
+
+# List identities
+puts '=== Identities ==='
+identities = DIDWW::Client.identities.all
+puts "Found #{identities.size} identities"
+
+identities.first(10).each do |identity|
+  puts "\nIdentity: #{identity.id}"
+  puts "  Name: #{identity.first_name} #{identity.last_name}"
+  puts "  Phone: #{identity.phone_number}"
+  puts "  Type: #{identity.identity_type}"
+  puts "  Verified: #{identity.verified}"
+  puts "  Created: #{identity.created_at}"
+end
+
+# List addresses
+puts "\n=== Addresses ==="
+addresses = DIDWW::Client.addresses
+            .includes(:identity)
+            .all
+
+puts "Found #{addresses.size} addresses"
+
+addresses.first(10).each do |address|
+  puts "\nAddress: #{address.id}"
+  puts "  Street: #{address.address}"
+  puts "  City: #{address.city_name}"
+  puts "  Postal Code: #{address.postal_code}"
+  puts "  Verified: #{address.verified}"
+  if address.identity
+    puts "  Identity: #{address.identity.first_name} #{address.identity.last_name}"
+  end
+end
+
+# List proof types
+puts "\n=== Proof Types ==="
+proof_types = DIDWW::Client.proof_types.all
+puts "Found #{proof_types.size} proof types"
+
+proof_types.first(10).each do |pt|
+  puts "#{pt.name} (#{pt.entity_type})"
+end
+
+puts "\n=== Identities and Proofs Workflow ==="
+puts '1. Create an identity with personal information'
+puts '2. Create an address linked to the identity'
+puts '3. Encrypt and upload identity/address documents'
+puts '4. Create proofs attached to identity/address with uploaded files'
+puts '5. Monitor verification status'
+puts "\nNote: Creating and uploading encrypted files requires additional SDK setup."